summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorOrangerot <purple@orangerot.dev>2023-04-10 22:59:49 +0200
committerOrangerot <purple@orangerot.dev>2023-04-10 22:59:49 +0200
commitb0a8acd23c0a4ac5058dd8ea0c7dcb422929ebf1 (patch)
tree731342239a754b8f2133dda7f144e2d544ffaccb /README.md
parentaf9d2c446ea5d8ed9d7d13b364f517abcaeb0ae5 (diff)
added README with installation instructions
Diffstat (limited to 'README.md')
-rw-r--r--README.md72
1 files changed, 72 insertions, 0 deletions
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
+