Skip to content

getulysse/ulysse

Repository files navigation

Ulysse

Version License

Ulysse is a simple CLI tool for blocking your distracting apps and websites.

Prevent distractions by blocking your most distracting apps and websites, even if you are the administrator of your computer.

Warning

The shield mode block root access to your computer and can block you from disabling Ulysse.

Make sure to remember your password.

If you are blocked, you can still disable Ulysse by running the following commands from a live USB:

rm /etc/sudoers.d/ulysse
usermod -s /bin/bash root # Or edit /etc/passwd file
echo 'nameserver 9.9.9.9' | tee /etc/resolv.conf

📋 Requirements

  • X11
  • Linux
  • Systemd
  • Node.js >= 14.0.0

✨ Features

  • Block your distracting apps and websites
  • Shield mode (no way to bypass)

📦 Installation

npm i -g ulysse

📖 Usage

Usage: ulysse [options] [command]

A simple CLI tool for blocking your distracting apps and websites.

Options:
  -v, --version   Show the version and exit
  -h, --help      Show this help message and exit

Commands:
  daemon          Start the Ulysse daemon
  blocklist       Manage the blocklist
  whitelist       Manage the whitelist
  shield          Enable or disable the shield mode
  help [command]  display help for command

Examples:
  ulysse daemon start
  ulysse blocklist add --app firefox
  ulysse whitelist add --website wikipedia.org
  ulysse blocklist add --website youtube.com -t 8h-20h
  ulysse shield enable

🎁 Support me

Please support me with a one-time or a monthly donation and help me continue my activities.

Github sponsor ko-fi Buy me a coffee liberapay Github Mastodon Twitter

📜 License

This project is licensed under the GNU GPL v3.0 - see the LICENSE.txt file for details

Free Software, Hell Yeah!