Firedecor

An advanced window decoration plugin for the Wayfire window manager.

Dependencies

• wayfire (duh)
• librsvg
• boost

Installation

• Using the AUR:

  yay -S wayfire-firedecor-git

• Building from source:

  git clone https://github.com/AhoyISki/Firedecor
  cd Firedecor
  meson build
  meson compile -C build
  sudo meson install -C build

Goals

• [x] Implement rounded corners;
• [x] Implement individual border sizes;
• [x] Implement app icons;
• [x] Implement title bars on any direction;
• [x] Implement completely modular decoration placement;
• [x] Implement individual corner rounding;
• [x] Multiple corner radii *Implemented as either the corner is there, or it is not;
• [x] Implement multiple themes.
• [x] Add accent colors to be used on anywhere on edges;
• [x] Implement a maximum title size with potentially animated title scrolling;
• [ ] Declare a minimum window size so the decorations can not look disgusting on small windows;
• [ ] Implement shadows.

Configuration

Example Configs

Here's what the default configuration would look like:

It's supposed to give off a "macOS" feel. Paste this into your wayfire.ini and add firedecor to your active plugins to get started.

This is my own configuration, feel free to copy it if you want

Screenshots

Left side decoration: Using:

border_size = 10 30 10 10
layout = - P5 title | | minimize p maximize p close P5 -

???:

?̷̛͈͐̃̈́̀̇́̑͛̓͋̌?̴̡̘̯͙̩̂̑̅̆̕?̶͍̣́̅̐̔͂̅͐̿͌͝: (very laggy)

Some ideas for accents

• Selective accents:

  layout = a P7 icon p title P7 a | | a P7 minimize p maximize p close P7 a 

• Connecting accents:

  layout = a | icon p title | P7 minimize p maximize p close P7 Atrtl - a P80 Atl - a | | Ablbr - a P80 Abr

• Framed outline:

  border_size = 10
  layout = a P100 Atl!\\ | | a P100 Atr/ - a P90 A!\\ | | a P90 A/ - a P100 Abl!/ | | a P100 Abr\\ - a P90 A!\\ | | a P90 A/

• Partial outlines using the same color for accents and the background:

  layout = P7 icon p title p a | | A p minimize p maximize p close P7 - a | | A - a | | Ablbr - a | | A

• Scroll-like decoration using visible outlines with an invisible background:

  layout = a | icon p title | minimize p maximize p close P7 a - - P5 a | | a P5

• Connecting outlines with accents for cool effects (I think this one looks really cool):

  layout = | a P15 icon p title P15 A\/ |

App Icon Debugging

The plugin will automatically try to retrieve icons from the file system, in order to display them on icon symbols on your windows. It will first look for folders matching your icon_theme. If it doesn't find the icons there, it will look in the remaining folders (hicolor, adwaita, breeze, in that order). However, sometimes, it just fails, and even if there is an icon for said app, the app's app_id is too terrible to find a suitable image, e.g. Osu!lazer has an app_id of "dotnet", which is completely unusable. If this ends up happening, the plugin will use a backup icon, provided by the plugin itself. But you also have the ability to manually set icons for your apps. Here's how:

1. Set debug_mode to true;
2. Open your app, this should tell you what its app_id is, if you have a title in layout;
3. Find the icon for this app, it can be anywhere in the computer, and can be either a png or an svg file;
4. Find the file ~/.local/share/firedecor_icons, it should be automatically created by the plugin;
5. Find the line containing the app_id, it should look like my_app_id /full/path/to/default/icon;
6. Replace the path in that line with the one you found earlier;
7. Done!