Skip to content

Simple CLI tool for blocking your distracting apps and websites.

License

Notifications You must be signed in to change notification settings

getulysse/ulysse

Repository files navigation

Ulysse

Version License Code Climate

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' | sudo tee /etc/resolv.conf

📋 Requirements

  • Linux
  • 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]

  Ulysse: A simple and powerful tool to block your distracting apps and websites.

Options:
  -b, --block TARGET [-t, --time VALUE]
                           Block a specific website or application. Optionally, add a time-based setting.
                           The VALUE format can include usage limits, specific time intervals,
                           or a quick block duration.
                           Examples: 
                             'ulysse -b example.com' (block indefinitely)
                             'ulysse -b example.com -t 10m' (block for a short duration)
                             'ulysse -b MyAppName -t 10h-18h' (block during specific hours)

  -u, --unblock TARGET     Unblock a specific website or application.
                           Example: 'ulysse -u example.com' or 'ulysse -u MyAppName'.

  -w, --whitelist TARGET   Whitelist a specific website.
                           Example: 'ulysse -w example.com'.

  -s, --shield [on|off] [-p, --password VALUE]
                           Enable or disable shield mode to prevent jailbreak.
                           By default, the shield mode is on. Use 'off' along with a password to disable it.
                           The password is required to disable the shield mode.
                           Example: 'ulysse -s on' to enable or 'ulysse -s off -p myp@ssw0rd' to disable.

  -d, --daemon             Run Ulysse as a daemon.
                           Example: 'ulysse -d' or 'ulysse --daemon'.

  -v, --version            Show the version and exit.

  -h, --help               Show this message and exit.

🎁 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!