Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion .github/workflows/theme-checks.yml
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ jobs:
python3 tests/test_installer_failures.py
python3 tests/test_installer_preservation.py
python3 tests/test_icons.py
python3 tests/test_color_updates.py
python3 tests/test_flatpak_installer.py
python3 tests/test_manual_installation.py
python3 tests/test_theme.py
Expand Down Expand Up @@ -202,7 +203,7 @@ jobs:
DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \
git ca-certificates cinnamon cinnamon-session dbus-x11 \
python3-gi python3-cairo python3-gi-cairo gir1.2-gtk-3.0 \
xvfb xauth libgl1-mesa-dri
xvfb xauth xdotool libgl1-mesa-dri
- uses: actions/checkout@v7
- name: Check Cinnamon preference activation
run: python3 tests/test_install_settings.py DesktopSettingTests.test_cinnamon_activation
Expand All @@ -215,6 +216,8 @@ jobs:
python3 tests/report.py xvfb-run -a -s '-screen 0 1600x1200x24 +extension GLX +render -noreset' \
dbus-run-session -- python3 tests/cinnamon_colors.py . /tmp/cinnamon-color-evidence
python3 tests/report.py python3 tests/accent_native.py cinnamon /tmp/cinnamon-color-evidence/accents
python3 tests/report.py xvfb-run -a -s '-screen 0 1600x1200x24 +extension GLX +render -noreset' \
dbus-run-session -- python3 tests/cinnamon_accent_update.py . /tmp/cinnamon-color-evidence/live-updates
- name: Upload Cinnamon color evidence
if: always()
uses: actions/upload-artifact@v7
Expand Down
6 changes: 4 additions & 2 deletions ACCENT_COLORS.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,8 +86,10 @@ semantic mode/status colors and user-defined ANSI slots stay separate.

The Bash installer combines the base runtime with one verified overlay. It
installs no palette sources, compiler or other presets. Rerunning retains the
installed color unless another is chosen. Rerun with the same optional extras
to refresh copied app snippets; existing GTK4/Flatpak links follow the installed
installed color unless another is chosen. **Change installed colors** (or
`--recolor`) refreshes existing copied app snippets and installed folder icons.
Folder icons default to matching but can use an independently selected preset.
Existing GTK4/Flatpak links follow the installed
theme. App themes still need selection in their own applications.

Shell 46 and 51 use the selected theme preset for all eight colors, including
Expand Down
15 changes: 15 additions & 0 deletions COMPATIBILITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -175,6 +175,21 @@ by the environment's namespace restrictions. Budgie's built-in-theme-disabled
configuration, native Wayland Cinnamon/Xfce sessions, and a full GNOME/MATE
login session were not verified.

## Cinnamon accent updates (2026-10-19)

A same-session blue-to-pink reinstall reproduced stale menu focus, calendar
and taskbar CSS on Cinnamon 6.0.4 and 6.6.9. The selected theme name did not
change, so Cinnamon retained its old stylesheet while newly loaded assets
could already use the new accent. The installer now calls Cinnamon's public
`ReloadTheme` D-Bus method when Adwaita-AMOLED is selected.

Disposable non-root X11 sessions on both versions passed all eight accents,
including a return to blue: 16 update transitions, 126 resolved style assertions
and 36 menu/calendar screenshots in total. Tests cover both search-entry IDs,
today's calendar date, grouped/classic taskbar states and popup hover, plus
actual painted menus and the mapped calendar widget. This does not establish
coverage of every third-party applet, extension or Wayland session.

## Official references

- [GNOME 51 build manifest](https://github.com/GNOME/gnome-build-meta/tree/51.0)
Expand Down
40 changes: 36 additions & 4 deletions INSTALLING.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,11 @@ In a terminal this opens guided setup:
and selected-app Flatpak configuration.
4. **Accent color** chooses blue (default), yellow, gold, purple, green, red,
orange or pink, then returns to the main menu. Continue with Install/update.
5. **Folder icon color** independently chooses a folder preset; **Match theme**
is the default. Installation also offers these color choices directly.
6. **Change installed colors** updates the installed theme and existing copied
app/icon themes without selecting all components again. It does not install
missing optional components or replace custom GTK4 CSS.

Numbered choices need only Enter or a number. Setup shows destinations and
existing GTK4 override paths before its final **Apply / Cancel / Preview**
Expand Down Expand Up @@ -110,9 +115,27 @@ and on the staged theme. The full collection of overlays is not installed.
Rerunning from a newer download retains the valid installed `accent-name`
marker unless `--accent` selects another color. Older installations without a
marker use blue. To return to blue, run `./install.sh --accent blue`.
Rerun with the same optional extras to refresh their copied app snippets;
Use **Change installed colors** to refresh existing copied app snippets and
installed folder icons together, or run:

```bash
./install.sh --recolor --accent pink
./install.sh --recolor --accent purple --icon-accent green
./install.sh --recolor --icon-accent match
```

For ordinary installation/update, select the optional extras again to update them;
GTK4/Flatpak links already referencing this theme follow the changed theme files.
Restart apps and reload Shell/Cinnamon as appropriate. Separate user and system
Restart affected apps; GNOME Shell may need a session restart. Cinnamon's selected
Adwaita-AMOLED theme reloads automatically through its public D-Bus API, including
when its theme name stays unchanged. If the session bus or `gdbus` is unavailable,
setup prints a manual reload/reselection hint. From the Cinnamon session, run:

```bash
gdbus call --session --dest org.Cinnamon --object-path /org/Cinnamon --method org.Cinnamon.ReloadTheme
```

Separate user and system
installations each retain their own color. Shared-system guided setup also has
an Accent color choice.

Expand Down Expand Up @@ -347,9 +370,16 @@ icon theme: our folder artwork uses the selected accent, while application,
symbolic and other icons fall back to **Adwaita**, then **hicolor**.
Your current application icons may therefore change too.

Folders default to **Match theme accent**. Choose another folder color in the
main menu or when selecting the icon component. This is independent of GTK,
Qt and other app accents. The installed `icon-accent` marker remembers `match`
or the explicit color; `accent-name` remembers the theme accent. No installer
database is needed. Older installations default to matching.

```bash
./install.sh --icons # Copy without selecting
./install.sh --activate-icons --accent green # Copy and select explicitly
./install.sh --icons --accent pink --icon-accent gold # Pink UI, gold folders
./install.sh --icons --remove # Remove the optional icon component and GTK theme
```

Expand All @@ -373,8 +403,10 @@ If qt5ct/qt6ct manages your Qt appearance, select **Adwaita-AMOLED** in its

GNOME/Budgie, Cinnamon, MATE and Xfce support explicit automatic selection.
On other desktops, use Appearance settings. Copying icons alone never changes
the selected icon theme. Rerun with **--icons** (or select the component again
in the menus) to update its files and match a changed accent. Existing icon
the selected icon theme. **Change installed colors** or `--recolor` refreshes
installed icons, retaining an independent color or following the theme when
set to **Match theme**. Normal updates use **--icons** or select the component
again. Restart file managers if they cache old icons. Existing icon
checkouts, symlink destinations and unlisted local files are preserved and
reported as conflicts. A separate legacy `~/.icons/Adwaita-AMOLED` is reported
if it could shadow the new installation.
Expand Down
7 changes: 5 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,11 +87,14 @@ extract it, and open a terminal inside the **Adwaita-AMOLED** folder:
Run user setup **without sudo**. The installer uses Bash; no Python, compiler
or additional menu package is required.

Choose **Accent color** if you want a different preset, then **Install/update
for this user**. Guided setup offers GTK4/libadwaita styling, desktop selection,
Choose **Install/update for this user**. Setup asks for a theme accent and offers GTK4/libadwaita styling, desktop selection,
matching supported GNOME Shell styling, optional app themes and folder icons. Review the
changes, then choose **Apply**, **Cancel** or **Preview**.

Folder icons default to **Match theme**, or you can choose their color separately.
Later, **Change installed colors** refreshes the theme and existing app/icon
themes together. Cinnamon reloads its selected theme automatically.

Selecting GTK4/libadwaita setup replaces existing CSS/assets overrides **without
backups**; guided setup defaults to keeping existing overrides. App extras
still need selection or inclusion in each application.
Expand Down
1 change: 1 addition & 0 deletions icon-accent
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
match
Loading