Show Files from a Directory on the Desktop for wlroots based Compositors
Go to file
2025-10-04 23:29:07 +02:00
.gitignore Initial Commit 2023-04-05 13:09:05 +02:00
dicons.c multi-monitor support 2024-02-25 16:20:01 +01:00
LICENSE Initial Commit 2023-04-05 13:09:05 +02:00
Makefile Add make debug 2023-10-16 17:14:36 +02:00
README.md doc: usage section in readme (fixes #16) 2025-10-04 23:29:07 +02:00

desktop-icons

Show Files from a Directory on the Desktop

Features

  • Show content from a folder as Icons on the Desktop
  • Use xdg_user_dir to use the default desktop directory
  • Start default application for the active file
  • Update the Icons on changes to the directory (added/removed files)
  • Drag and Drop Files from/to the Desktop
  • Launching Apps from the Desktop
  • Multi-Monitor Support
  • Thumbnails for Images/Documents
  • Sort Rows of List Store based on Name/Type/Date
  • Context-Menu for creating files

Supported Desktops

Quoted from gtk-layer-shell

This application only works on Wayland, and only on Wayland compositors that support the Layer Shell protocol. Layer shell is supported on:

  • wlroots based compositors (such as Sway)
  • Mir-based compositors (some may not enable the protocol by default and require --add-wayland-extension zwlr_layer_shell_v1)

Layer shell is not supported on:

  • Gnome-on-Wayland
  • Any X11 desktop

Getting Started

Dependencies

  • gtk+-3.0
  • gtk-layer-shell

Arch

sudo pacman -S gtk3 gtk-layer-shell

Installation

git clone https://github.com/Geronymos/desktop-icons
cd desktop-icons
make
sudo make install

Uninstall

sudo make uninstall

Usage

dicons

It's recommended to have this automatically start with your Wayland compositor. For Sway append the following to your config file .config/sway/config :

exec dicons

Development

Dependencies

  • bear

To have warnings and autocompletion with clangd in Vim you can generate the compile-commands.json with

make clangd

License

This project is licensed under the GPL-3 License - see the LICENSE file for details