UNPKG

ulysse

Version:

A simple CLI tool for blocking your distracting apps and websites

github.com/getulysse/ulysse

getulysse/ulysse

84 lines (61 loc) • 3.19 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
# Ulysse [![Version](https://img.shields.io/npm/v/ulysse?label=Version&style=flat&colorA=2B323B&colorB=1e2329)](https://www.npmjs.com/package/ulysse) [![License](https://img.shields.io/badge/license-GPL%20v3%2B-yellow.svg?label=License&style=flat&colorA=2B323B&colorB=1e2329)](https://raw.githubusercontent.com/johackim/ulysse/master/LICENSE.txt) 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: > > ```bash > 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 - [x] Block your distracting apps and websites - [x] Shield mode (no way to bypass) ## 📦 Installation ```bash npm i -g ulysse ``` ## 📖 Usage ```txt 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](https://img.shields.io/badge/github-Support%20my%20work-lightgrey?style=social&logo=github)](https://github.com/sponsors/johackim/) [![ko-fi](https://img.shields.io/badge/ko--fi-Support%20my%20work-lightgrey?style=social&logo=ko-fi)](https://ko-fi.com/johackim) [![Buy me a coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-Support%20my%20work-lightgrey?style=social&logo=buy%20me%20a%20coffee&logoColor=%23FFDD00)](https://www.buymeacoffee.com/johackim) [![liberapay](https://img.shields.io/badge/liberapay-Support%20my%20work-lightgrey?style=social&logo=liberapay&logoColor=%23F6C915)](https://liberapay.com/johackim/donate) [![Github](https://img.shields.io/github/followers/johackim?label=Follow%20me&style=social)](https://github.com/johackim) [![Mastodon](https://img.shields.io/mastodon/follow/1631?domain=https%3A%2F%2Fmastodon.ethibox.fr&style=social)](https://mastodon.ethibox.fr/@johackim) [![Twitter](https://img.shields.io/twitter/follow/_johackim?style=social)](https://twitter.com/_johackim) ## 📜 License This project is licensed under the GNU GPL v3.0 - see the [LICENSE.txt](https://raw.githubusercontent.com/johackim/ulysse/master/LICENSE.txt) file for details **Free Software, Hell Yeah!**