92 lines
3.1 KiB
Markdown
92 lines
3.1 KiB
Markdown
# DnDBuster
|
|
|
|
A timer that notifies you - even if "do not disturb" is enabled.
|
|
|
|
## ToC
|
|
|
|
<!-- TOC -->
|
|
* [DnDBuster](#dndbuster)
|
|
* [ToC](#toc)
|
|
* [Application IDs](#application-ids)
|
|
* [.desktop entry](#desktop-entry)
|
|
* [GTK resources](#gtk-resources)
|
|
* [mypy](#mypy)
|
|
* [Alternatives](#alternatives)
|
|
<!-- TOC -->
|
|
|
|
## Application IDs
|
|
|
|
https://developer.gnome.org/documentation/tutorials/application-id.html
|
|
|
|
Used by
|
|
|
|
- GtkApplication
|
|
|
|
> identifying your application to the system, for ensuring that only one instance of your application is running at a given time, and as a way of passing messages to your application
|
|
|
|
- D-Bus
|
|
|
|
> to name your application on the message bus. This is the primary means of communicating between applications
|
|
|
|
- name of the .desktop file for your application
|
|
|
|
> This file is how you describe your application to the system (so that it can be displayed in and launched by GNOME).
|
|
|
|
## .desktop entry
|
|
|
|
https://wiki.gnome.org/HowDoI/GNotification
|
|
|
|
The GNOME desktop environment needs a `.desktop` file that matches your applications ID. Otherwise, sent notifications are not displayed!
|
|
|
|
> Warning: gnome-shell uses desktop files to find extra information (app icon, name) about the sender of the notification. If you don't have a desktop file whose base name matches the application id, then your notification will not show up.
|
|
|
|
During development, we created a dummy vile at `~/.local/share/applications/de.p1st.dndbuster.desktop` with content:
|
|
|
|
```
|
|
[Desktop Entry]
|
|
Name=DnDBuster
|
|
Comment=A simple timer app
|
|
Exec=nix-shell /home/yoda/Downloads/git/DnDBuster-python/shell.nix --run 'export PYTHONPATH="${PYTHONPATH}:/home/yoda/Downloads/git/DnDBuster-python/src" && python /home/yoda/Downloads/git/DnDBuster-python/src/dndbuster/main.py'
|
|
Icon=dndbuster-stopwatch
|
|
Terminal=false
|
|
Type=Application
|
|
Categories=Application;
|
|
```
|
|
|
|
Copy `watch-icon.svg` to `~/.local/share/icons/hicolor/scalable/apps/dndbuster-stopwatch.svg`
|
|
|
|
## GTK resources
|
|
|
|
- https://www.gtk.org/docs/language-bindings/python
|
|
|
|
- https://gitlab.gnome.org/GNOME/pygobject/-/tags
|
|
- https://gitlab.gnome.org/GNOME/libadwaita/-/tags
|
|
|
|
- https://pygobject.gnome.org/tutorials/gtk4/application.html#actions
|
|
- These actions can be grouped together into a `Gio.ActionGroup` and when these groups are added to a widget with `Gtk.Widget.insert_action_group()` they will gain a prefix. Such as “win” when added to a `Gtk.ApplicationWindow`. You will use the full action name when referencing it such as “app.about” but when you create the action it will just be “about” until added to the application.
|
|
|
|
- https://www.technett.io/post/dev/python-gtk-2/
|
|
- https://github.com/Taiko2k/GTK4PythonTutorial
|
|
- https://github.com/timlau/gtk4-python
|
|
- https://github.com/ToshioCP/Gtk4-tutorial
|
|
|
|
## mypy
|
|
|
|
https://mypy.readthedocs.io/en/latest/getting_started.html
|
|
|
|
```shell
|
|
mypy src/dndbuster/app.py
|
|
```
|
|
|
|
## Alternatives
|
|
|
|
https://man.archlinux.org/man/notify-send.1.en
|
|
|
|
```shell
|
|
nix-shell -p libnotify
|
|
```
|
|
```shell
|
|
sleep 30m
|
|
notify-send -u critical -a PleaseDisturbTimer "Timeout" "The time is over and your do-not-disturb mode just got busted!"
|
|
```
|