gousbnotify

USB connect/disconnect notifications for Linux.

• Real-time device detection.
• Show pop-up notification.
• Play custom notification sound.
• Portable, just single binary (default sounds embedded).
• Built-in systemd service installer (no root access).

Install

mkdir ~/.local/bin
cd ~/.local/bin
wget -O gousbnotify https://github.com/meyt/gousbnotify/releases/latest/download/gousbnotify-linux-amd64
chmod +x gousbnotify

Now you can run it

./gousbnotify

Parameters

All parameters can be used with or without -install

• -install: Install and activate background service. it will also starts automatically on system startup.
• -uninstall: Stop and uninstall the background service.
• -nosound: Disables the sound notification
• -nonotif: Disables the pop-up notification.
• -connect-sound: Sound file path for "Connect".
• -disconnect-sound: Sound file path for "Disconnect".

For example:

./gousbnotify -install \
    -connect-sound="/mnt/drivec/Windows/Media/Windows Hardware Insert.wav"
    -disconnect-sound="/mnt/drivec/Windows/Media/Windows Hardware Remove.wav"

Credits

• Based on udev, libnotify and alsa
• Default Sounds: https://cgit.freedesktop.org/sound-theme-freedesktop/
• Assisted AI agents: DeepSeek, Grok, Perplexity, Gemini