Tutorial - trixie wayfire

hhh · 2025-08-31 13:31:48

Switch gedit for mousepad...

sudo apt purge --autoremove gedit && sudo apt install mousepad

Switch nautilus for thunar...

sudo apt purge --autoremove nautilus* && sudo apt install thunar thunar-archive-plugin tumbler

Don't forget to adjust your keyboard shortcuts accordingly.

Regarding hand-editing wayfire.ini to change the keyboard layout, don't forget that the "[input]" header was commented out in the original, so if you didn't uncomment that line nothing would change. wcm uncommented the line for you when it rewrote wayfire.ini.

unklar · 2025-08-31 19:20:01

I've arrived here: https://forums.bunsenlabs.org/viewtopic … 73#p145373

The ‘wayfire’ project is taking shape.
Many thanks to @hhh for this masterpiece of a tutorial. Great work!

I did everything as you said and it works. Sorry, I don't like the bird. I chose the airplane.

unklar · 2025-09-01 13:02:56

I had made a mistake.
In dconf-editor, the font Monofur was entered in the wrong field—corrected.

Windows
Windows that slide under the panel are partially unusable.
This happens when I haven't made sure there is enough space between them and the panel, e.g., gnome-control-center>wlan>gear/network settings.
Or, Celluloid>three dots>settings.

Maximized windows tend to flutter on right side of the desk when clicking on X. Sometimes this can only be “repaired” by logging out and back in.

Mousepad
Selected text>Edit>Copy not selectable
But right-clicking works

Conky
[autostart] in wayfire.ini

conky = sleep 2 && conky -c /home/unklar/.config/conky/conky.conf &

conky.conf (if you agree )

-- Variables: https://conky.cc/variables

conky.text = [[
${alignr}${font Futura Bk BT:pixelsize=110}${time %H:%M}
${alignr}${voffset -100}${font Futura Bk BT:pixelsize=24}${mem} / ${memmax}${font}
]];

and an additional blank line at the end

Edit:
I changed the Debian sources to the deb822 format.

Last edited by unklar (2025-09-01 13:07:06)

hhh · 2025-09-01 20:30:02

I can't really speak to any bug. The project is only at v.9 on Debian, v.10 was released just a few days ago...

https://wayfire.org/2025/08/27/Wayfire-0-10.html

I've had some flickering/graphic glitches and some crashes as well using integrated Intel. Remarkably few, but still. It's worth rechecking every line of wayfire.ini and wf-shell.ini, a single typo might break everything. Definitely worth checking the autostart file. I got my additional lines from a 2022 post, so that's not great...

https://bbs.archlinux.org/viewtopic.php … 6#p1978376

As to the wallpaper... birds are stupid, dangerous, liquid pooping, flying dinosaur government drones, so you're correct to stay away. The modern flyer is a good choice, looks really sweet.

hhh · 2025-09-01 23:04:13

I'm not going to go into configuring swaylock or swaylock-idle here, but we should at least set the wallpaper.

Create ~/.config/swaylock/config and paste this (correct your user name from 'rachael')...

image=/home/rachael/Pictures/wall.jpg

hhh · 2025-09-01 23:08:05

Bluetooth is easy, just...

sudo apt install blueman

If you want to use a panel applet instead of opening bluetooth-manager from the main menu, add 'blueman-applet' to the Autostart plugin. After pairing the new Bluetooth device, verify the signature by clicking the checkmark (Trust) in the manager window. Logout/login to see the applet.

hhh · 2025-09-01 23:13:56

I'll have to look over everything, but I think we're done?

Configuring gdm3 is a mess, but if you hate the black background I recommend installing flatpak and flathub and installing gdm-settings, set a blue-ish wallpaper (put it in /usr/share/images or somewhere else in the root directory), then remove that horrible broken flatpak, and flathub and flatpak itself, and never, ever think of changing it again because the whole process is filthy. I'm not even linking the package, yucky.

To set a user icon, click the Network icon in the panel, we can use gnome-settings-manager here. In the left pane, scroll to the bottom, System>Users>pencil icon on the avatar to edit, set your pic and center it, you don't need to unlock any privileges.

Remove the Debian text-logo by renaming /usr/share/images/vendor-logos/logo-text-version-64.png to anything (/usr/share/images/vendor-logos/logo-text-version-64.png.bak works).

hhh · 2025-09-01 23:25:42

Ah, Window Rules. Very powerful, and the one plugin I've found so far that won't let you edit the config via the Config Manager, so do it by hand.

blueman-manager's window increases in size every time I open it until it's finally full screen. I'll set a rule in wayfire.ini to change it (around line #360 at this point)...

[window-rules]
rule_1 = on created if app_id is 'blueman-manager' then resize 700 500

I got the app_id by hoping it was the 'Exec=' command in blueman-manager's *.desktop file. Hey, it works! Label your next rule 'rule_2 = '...

https://github.com/WayfireWM/wayfire/wi … ndow-rules

hhh · 2025-09-01 23:39:11

@unklar, let's try disabling the Idle plugin. It's using a lot of graphics processing for nothing, it might help cleaning up the glitches to kill it. As a matter of fact, there's a few others that I'm going to kill also... Alpha, Invert, Zoom, and Fisheye.

hhh · 2025-09-02 00:19:43

https://github.com/WayfireWM/wayfire/discussions/2808

hhh · 2025-09-02 00:58:18

By the way, kill or change your CapsLk key in the [Input] plugin under Keyboard>XKB Options. Example...

caps:none

I guess the last thing is wlogout. It has too many options for me and the highlighting is obnoxious and confusing. I'm reducing the grid to 4 options and keep the highlight to the cursor. Create these folders and files. Here is my ~/.config/wlogout/layout file...

{
    "label" : "logout",
    "action" : "loginctl terminate-user $USER",
    "text" : "Logout",
    "keybind" : "l"
}
{
    "label" : "shutdown",
    "action" : "systemctl poweroff",
    "text" : "Shutdown",
    "keybind" : "s"
}
{
    "label" : "reboot",
    "action" : "systemctl reboot",
    "text" : "Reboot",
    "keybind" : "r"
}
{
    "label" : "suspend",
    "action" : "systemctl suspend",
    "text" : "Suspend",
    "keybind" : "u"
}

Also create style.css in the same folder...

* {
	background-image: none;
	box-shadow: none;
}

window {
	background-color: rgba(12, 12, 12, 0.9);
}

button {
    border-radius: 0;
    border-color: black;
	text-decoration-color: #FFFFFF;
    color: #FFFFFF;
	background-color: #1E1E1E;
	border-style: solid;
	border-width: 1px;
	background-repeat: no-repeat;
	background-position: center;
	background-size: 25%;
}

button:focus, button:active {
	background-color: #2E3436;
	outline-style: none;
}

#logout {
    background-image: image(url("/usr/share/wlogout/icons/logout.png"), url("/usr/local/share/wlogout/icons/logout.png"));
}

#suspend {
    background-image: image(url("/usr/share/wlogout/icons/suspend.png"), url("/usr/local/share/wlogout/icons/suspend.png"));
}

#shutdown {
    background-image: image(url("/usr/share/wlogout/icons/shutdown.png"), url("/usr/local/share/wlogout/icons/shutdown.png"));
}

#reboot {
    background-image: image(url("/usr/share/wlogout/icons/reboot.png"), url("/usr/local/share/wlogout/icons/reboot.png"));
}

You can only change the actual grid layout from the command, so change the wlogout command in "Command" to...

wlogout -b 2

I think that's it.

/tutorial

unklar · 2025-09-02 11:35:18

hhh wrote:

I can't really speak to any bug. The project is only at v.9 on Debian, v.10 was released just a few days ago...
https://wayfire.org/2025/08/27/Wayfire-0-10.html

Thanks for clarifying that!
Then I had a problem understanding, which led me to ask why trixi and not unstable?

It is to be expected that the new features (v.10) will first appear in experimental/unstable -- nothing for a long time -- and eventually in trixi. I may be dead by then.

Or am I misunderstanding something?

unklar · 2025-09-02 11:41:33

I'm a little shocked to see this today:

Is there absolutely NOTHING in the CSS path line of your panel?

unklar · 2025-09-02 13:15:37

Bluetooth
The devices are recognized. However, I cannot connect the two SoundCore mini 2 speakers because I currently see no way to enter the code for pairing mode. The smartphone works.
Closing the Bluetooth Manager also causes the Bluetooth icon to disappear from the panel.

The Wi-Fi icon on the panel is dark and barely visible. Where can I change this?

What works well is keepassxc.
I can log into the forum without any problems using the browser icon.

Last edited by unklar (2025-09-02 13:29:59)

hhh · 2025-09-02 15:24:36

This tutorial is for stable as I'm trying to keep this fairly experimental desktop stable! BTW, any visual glitches I'm seeing now are after theming changes and a reboot clears them up.

No path to the panel css, it's using the default. Have at it...

https://github.com/WayfireWM/wf-shell/t … r/data/css

For your WiFi icon, what icon and gtk themes have you set? In the Panel plugin under Network you can toggle "Network Icon Invert Color" (Battery also has that option).

unklar · 2025-09-03 08:54:59

hhh wrote:

This tutorial is for stable as I'm trying to keep this fairly experimental desktop stable! BTW, any visual glitches I'm seeing now are after theming changes and a reboot clears them up.

I think I'll set up the sources on unstable due to the relatively short time since Trixi was released as stable. If it breaks, I'll be smarter, because I've had the unstable sources on labwc and hyprland from the start and I'm more than satisfied with the stability.

Logging out and logging back in usually suffices.

The memory consumption at startup is surprisingly high at ~1.16 GiB. After 10 seconds, it drops back to ~900 MiB.

No path to the panel css, it's using the default. Have at it...

Ok.

For your WiFi icon, what icon and gtk themes have you set? In the Panel plugin under Network you can toggle "Network Icon Invert Color" (Battery also has that option).

I had already tested the color.
What you said is installed, Papirus-Dark.

unklar · 2025-09-04 14:13:03

I did it and set it up as ‘unstable’. ~456 packages were updated. Painless.

unklar · 2025-09-06 17:13:01

Actually, since updating to ‘unstable’, I haven't noticed any more graphics glitches or errors.
That surprises me, but then again, it doesn't.

https://forums.bunsenlabs.org/viewtopic … 26#p145426
That looks a bit strange, but I'm not sure I've done it right.

Expo, 2x2 grid, where do you set that? I don't have 4, I have 9...
https://github.com/WayfireWM/wayfire/di … t-14286493

unklar · 2025-09-07 09:45:10

OK, found it. Reduced it to 15% and added the icons.

    background-size: 15%;

{
    “label” : “hibernate”,
    “action” : “”,
    “text” : “Hibernate”,
    “keybind” : “”
}
{
    “label” : “lock”,
    “action” : “”,
    “text” : “Lock”,
    “keybind” : “”
}

#hibernate {
    background-image: image(url("/usr/share/wlogout/icons/hibernate.png"), url("/usr/local/share/wlogout/icons/hibernate.png"));
}

#lock {
    background-image: image(url("/usr/share/wlogout/icons/lock.png"), url("/usr/local/share/wlogout/icons/lock.png"));
}

unklar · 2025-09-07 14:01:32

unklar wrote:

Expo, 2x2 grid, where do you set that? I don't have 4, I have 9... wink
https://github.com/WayfireWM/wayfire/di … t-14286493

OK, I found that too after your excellent tutorial.

Edit:
I think I've already said this, but it's extremely easy to work with the keepassxc browser plugin on Wayfire. It works just as it should!
With labwc and hyprland, I always have to use the clipboard because the fields aren't filled in. That's counterproductive.
This raises the question: what does Wayfire do differently with Wayland?

Last edited by unklar (2025-09-07 14:07:40)

#21 2025-08-31 13:31:48

Re: Tutorial - trixie wayfire

#22 2025-08-31 19:20:01

Re: Tutorial - trixie wayfire

#23 2025-09-01 13:02:56

Re: Tutorial - trixie wayfire

#24 2025-09-01 20:30:02

Re: Tutorial - trixie wayfire

#25 2025-09-01 23:04:13

Re: Tutorial - trixie wayfire

#26 2025-09-01 23:08:05

Re: Tutorial - trixie wayfire

#27 2025-09-01 23:13:56

Re: Tutorial - trixie wayfire

#28 2025-09-01 23:25:42

Re: Tutorial - trixie wayfire

#29 2025-09-01 23:39:11

Re: Tutorial - trixie wayfire

#30 2025-09-02 00:19:43

Re: Tutorial - trixie wayfire

#31 2025-09-02 00:58:18

Re: Tutorial - trixie wayfire

#32 2025-09-02 11:35:18

Re: Tutorial - trixie wayfire

#33 2025-09-02 11:41:33

Re: Tutorial - trixie wayfire

#34 2025-09-02 13:15:37

Re: Tutorial - trixie wayfire

#35 2025-09-02 15:24:36

Re: Tutorial - trixie wayfire

#36 2025-09-03 08:54:59

Re: Tutorial - trixie wayfire

#37 2025-09-04 14:13:03

Re: Tutorial - trixie wayfire

#38 2025-09-06 17:13:01

Re: Tutorial - trixie wayfire

#39 2025-09-07 09:45:10

Re: Tutorial - trixie wayfire

#40 2025-09-07 14:01:32

Re: Tutorial - trixie wayfire

Board footer