Lizard, the 8ch monitor
Lizard is a command line (CLI) program for monitoring 8ch threads. After you add a thread to its watchlist, it can connect to 8ch and check if new replies were made, notifying you if so. It will try to keep a local copy of the thread and the files in it in case the thread dies. It can also open all threads with new replies in your browser with a single command.
- Make sure you have Python 3
- Download the most recent
.whlpackage from under
- Install with pip:
pip3 install lizard-0.<VERSION HERE>-py3-none-any.whl
If upgrading, see wiki.
lizard without any arguments will print the help message explaining the syntax. It will also create a
~/lizard_data directory to store files.
After you install, run
lizard create to create a new database (if you don't have one already). Everything else will crash unless a valid database exists.
Add a thread to the database with
lizard a <URL>. Upon adding a thread, Lizard will immediately download a copy of the thread and the files in it. These will be put under
You can call
lizard r to refresh threads currently in the database, and see their status with
lizard rl combines these two steps. If you see threads with new activity (marked with
Y), you can open those in your default browser with
lizard o (tip: have the browser running already before you do this).
0.4 (in development)
Command syntax changes:
- Listing threads:
lizard la(list all) will produce the previous
lizard lwill list only items that have had something interesting happen (reply or 404).
lizard rlwill print the summary list.
lizard torwill now auto-open the tor captcha page for convenience. (#42)
- When any web request receives a 403, a more informative message is printed. (#40
lizard createcommand now working. (#43)
- This version changes syntax for some commands:
- Database creation:
- Conservative refresh:
lizard rcno longer a valid command
lizard rdoes conservative refresh
- Refresh all threads:
lizard rainstead of
- Database creation:
- Changed packaging system: Now building wheels which are compatible with
- Basic Tor support:
lizard towill open the threads using the onion domain.
lizard torwill also open the CAPTCHA page