Example desktop entry for Brave and validation docs

Author Mitja Felicijan <mitja.felicijan@gmail.com> 2026-05-11 03:09:27 +0200
Committer Mitja Felicijan <mitja.felicijan@gmail.com> 2026-05-11 03:09:27 +0200
Commit 277588b007da9f9654e51c8c1023b30bb3e8e510 (patch)
-rw-r--r-- README.md 35
1 files changed, 27 insertions, 8 deletions
diff --git a/README.md b/README.md
1 
`xdgctl` is a TUI for managing XDG default applications. View and set defaults for file categories without using `xdg-mime` directly.
 1 
`xdgctl` is a TUI for managing XDG default applications. View and set defaults
 
  
 2 
for file categories without using `xdg-mime` directly.
2 
  
 3 
  
3 
Built with C using [GLib/GIO](https://docs.gtk.org/gio/) and [termbox2](https://github.com/termbox/termbox2).
 4 
Built with C using [GLib/GIO](https://docs.gtk.org/gio/) and
 
  
 5 
[termbox2](https://github.com/termbox/termbox2).
4 
  
 6 
  
5 
https://github.com/user-attachments/assets/076c9934-f373-486d-9595-eec480e3a429
 7 
https://github.com/user-attachments/assets/076c9934-f373-486d-9595-eec480e3a429
6 
  
 8 
  
...
50 
make PREFIX=~/.local install
 52 
make PREFIX=~/.local install
51 
```
 53 
```
52 
  
 54 
  
53 
If you manually add new applications to your `~/.local/share/applications` directory, you might need to run `update-desktop-database` again.
 55 
If you manually add new applications to your `~/.local/share/applications`
 
  
 56 
directory, you might need to run `update-desktop-database` again.
54 
  
 57 
  
55 
### Arch Linux package
 58 
### Arch Linux package
56 
  
 59 
  
...
96 
xdg-mime default brave.desktop x-scheme-handler/https
 99 
xdg-mime default brave.desktop x-scheme-handler/https
97 
```
 100 
```
98 
  
 101 
  
99 
### Desktop Entry example
 102 
### Example Desktop Entry for Brave
100 
  
 103 
  
101 
```ini
 104 
```ini
102 
# ~/.local/share/applications/brave.desktop
 105 
# ~/.local/share/applications/brave.desktop
103 
[Desktop Entry]
 106 
[Desktop Entry]
104 
Exec=/home/m/Applications/brave
 107 
Version=1.0
105 
Type=Application
 108 
Type=Application
106 
Categories=Applications
 109 
Name=Brave
107 
Name=Brave Browser
 110 
GenericName=Web Browser
108 
MimeType=text/html;text/xml;application/xhtml+xml;x-scheme-handler/http;x-scheme-handler/https;
 111 
Comment=Brave browser
 
  
 112 
Exec=/home/m/Applications/brave --new-window %U
 
  
 113 
Terminal=false
 
  
 114 
Icon=brave
 
  
 115 
Categories=Network;WebBrowser;
 
  
 116 
MimeType=application/pdf;application/rdf+xml;application/rss+xml;application/xhtml+xml;application/xhtml_xml;application/xml;image/gif;image/jpeg;image/png;image/webp;text/html;text/xml;x-scheme-handler/http;x-scheme-handler/https;x-scheme-handler/chromium;
 
  
 117 
Actions=new-window;new-private-window;
 
  
 118 
  
 
  
 119 
[Desktop Action new-window]
 
  
 120 
Name=New Window
 
  
 121 
Exec=/home/m/Applications/brave --new-window
 
  
 122 
  
 
  
 123 
[Desktop Action new-private-window]
 
  
 124 
Name=New Private Window
 
  
 125 
Exec=/home/m/Applications/brave --incognito
109 
```
 126 
```
 
  
 127 
  
 
  
 128 
Validate file with `desktop-file-validate ~/.local/share/applications/brave.desktop`.
110 
  
 129 
  
111 
### Other useful commands/files
 130 
### Other useful commands/files
112 
  
 131 
  
...