Panel Profiles
A Cinnamon applet that saves named desktop layouts and restores them later,
exactly. Every profile brings back
panels, monitor placement, heights, autohide, icon and text sizes, every
applet in every zone, their order, and each applet’s own settings. A profile
can optionally include the desklet list, desklet settings and each desklet’s
own config.
Screenshots
The settings window:
Why it exists
Cinnamon usually remembers your panels. It forgets them in one specific place:
a multi-head VM where the second virtual display shows up after Cinnamon has
already started. You reboot the VM, Cinnamon boots with one monitor, and by
the time the second SPICE head appears the second panel and its applets are
gone. You recreate it by hand. Every reboot.
Panel Profiles fixes that. You set the panels up once, save the layout as a
profile, and restore it whenever you want with one click. It is also just
handy as a general layout manager: keep a Minimal profile, a Development
profile, a Presentation profile, and flip between them.
Features
- One clear profile type: panels and applets, with an optional Include
desklets checkbox when saving. - Exact restore: a profile brings back precisely what it was configured to
include. - Profiles apply only when you click them. Boot stays Cinnamon’s own.
- Modified detection: the menu tells you when the live layout no longer
matches the active profile, with an Update action. - Rename, duplicate and delete profiles in the applet’s settings window.
- Every load is transactional: a rollback snapshot is taken first and a
failed restore is undone automatically. - Restart Cinnamon and Configure entries right in the menu.
Install
No root needed. The applet lives in your user directory.
From a release package:
curl -fLO https://github.com/CurbSoftware/cinnamon-panel-profiles-applet/releases/latest/download/cinnamon-panel-profiles-applet.zip
unzip -o cinnamon-panel-profiles-applet.zip
mkdir -p ~/.local/share/cinnamon/applets
rm -rf ~/.local/share/cinnamon/applets/cinnamon-panel-profiles-applet@curbsoftware
cp -r cinnamon-panel-profiles-applet@curbsoftware/files/cinnamon-panel-profiles-applet@curbsoftware \
~/.local/share/cinnamon/applets/cinnamon-panel-profiles-applet@curbsoftware
Or straight from git:
git clone https://github.com/CurbSoftware/cinnamon-panel-profiles-applet.git || git -C cinnamon-panel-profiles-applet pull
cd cinnamon-panel-profiles-applet
mkdir -p ~/.local/share/cinnamon/applets
rm -rf ~/.local/share/cinnamon/applets/cinnamon-panel-profiles-applet@curbsoftware
cp -r files/cinnamon-panel-profiles-applet@curbsoftware \
~/.local/share/cinnamon/applets/cinnamon-panel-profiles-applet@curbsoftware
The rm -rf before the copy is the upgrade path: old files are removed so
nothing deleted upstream lingers, then the copy brings the new tree in.
Your applet settings and every saved profile live in
~/.config/cinnamon/spices/cinnamon-panel-profiles-applet@curbsoftware/ and
~/.config/cinnamon-panel-profiles/, both outside the install directory, so
they survive reinstalls.
Restart Cinnamon (Alt-F2, type r, Enter), then add it to a panel:
right-click a panel, choose Applets, find Panel Profiles, click the plus.
Use
The short version: save, break it, restore.
- Set up your panels the way you want them.
- Click Panel Profiles, then Save current layout, and give it a name.
Select Include desklets if this layout should restore them too. - Change whatever you like: move an applet, resize a panel, add a panel.
- Click the profile in the menu. It comes back exactly.
The menu opens straight into your profiles. The active profile sits at the
top in bold with a check; the rest follow alphabetically. When the live
layout drifts from it, its row gains a Modified tag and the menu offers an
Update action. Below the list: Restore previous layout, Save current layout,
Configure (the applet’s settings window) and Restart Cinnamon.
Rename, duplicate and delete profiles from the applet’s settings window
(Configure). The settings also carry a read-only row showing the connected
display count and what the active profile expects.
Restore behavior
Nothing restores automatically at boot; Cinnamon starts with whatever it
last saved. When you click a profile that expects more displays than are
connected, the applet waits for them (with a timeout) before restoring.
Settings, in the applet’s settings dialog:
- Manage saved profiles (rename, duplicate, delete)
- Stabilization delay and display wait timeout for restores
- One automatic rollback snapshot, also available from the applet menu
- Success and warning notifications
- Debug logging
Where profiles live
Everything is under:
~/.config/cinnamon-panel-profiles/
state.json
profiles/<id>.json
backups/last-good.json
- Profiles are the saved snapshots. One JSON file each.
- state.json tracks the active profile plus any in-flight restore.
- backups holds the rollback snapshot written before every load.
Directories are created mode 0700, files mode 0600. That means only your user
can read them.
Privacy
A profile is not just panel geometry. It includes the raw configuration of
every applet it references, and applet configs can hold things like account
names, tokens, or other private values. Treat profile files as private. Do
not share them without checking what is inside. If you ever add an export
feature or hand a profile file to someone, review it first.
Troubleshooting
The applet logs with a [PanelProfiles] prefix.
- Check
~/.xsession-errorsfirst:tail -f ~/.xsession-errors | grep PanelProfiles. journalctl --user -falso catches Cinnamon output on systemd sessions.- Press
Win+Lfor Looking Glass, then the Log and Extensions tabs. - If Cinnamon was started with a custom stderr target during development, the
log may be in a file like/tmp/wpN-cinnamon.loginstead.~/.xsession-errors
is the normal home for it.
Recovering a layout: load another profile from the menu. The rollback
snapshot in ~/.config/cinnamon-panel-profiles/backups/ is written before
every load and a failed restore is undone automatically.
Full reset: remove the state directory. The applet rebuilds it on next start.
rm -rf ~/.config/cinnamon-panel-profiles
Your panel layout itself is untouched by that; you only lose the saved
profiles and which ones were active.
If state.json is damaged, the applet renames it to a timestamped .corrupt
file, recreates a safe default, and leaves profile files untouched. If a
profile JSON is damaged, other profiles still load. Selecting the broken one
does not change Cinnamon.
Development
See DEVELOPMENT.md for the module map, test commands and the live-test
workflow. Schema notes are in docs/SCHEMA.md. Manual VM checks are in
docs/TESTING.md. Live Cinnamon 6.6.9 inspection notes are in RESEARCH.md.
