From b0a8acd23c0a4ac5058dd8ea0c7dcb422929ebf1 Mon Sep 17 00:00:00 2001 From: Orangerot Date: Mon, 10 Apr 2023 22:59:49 +0200 Subject: [PATCH] added README with installation instructions --- README.md | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..56e4677 --- /dev/null +++ b/README.md @@ -0,0 +1,72 @@ +# desktop-icon + +> Show Files from a Directory on the Desktop + +## Features + +- [X] Show content from a folder as Icons on the Desktop +- [X] Use xdg_user_dir to use the default desktop directory +- [X] Start default application for the active file +- [X] Update the Icons on changes to the directory (added/removed files) +- [ ] Dropping files on the Desktop +- [ ] Dragging files 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](https://github.com/wmww/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 +```sh +sudo pacman -S gtk3 gtk-layer-shell +``` + +### Installing + +```sh +git clone https://github.com/Geronymos/desktop-icons +cd desktop-icons +make +sudo make install +``` + +Uninstall +```sh +sudo make uninstall +``` + +### Development + +Dependencies +- bear + +To have warnings and autocompletion with clangd in Vim you can generate the +`compile-commands.json` with +```sh +make clangd +``` + +## License + +This project is licensed under the GPL-3 License - see the `LICENSE` file for details +