A command line (CLI) program for monitoring and downloading 8chan threads. Licensed under MIT.
Nevar pievienot vairāk kā 25 tēmas Tēmai ir jāsākas ar burtu vai ciparu, tā var saturēt domu zīmes ('-') un var būt līdz 35 simboliem gara.

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.



  1. Make sure you have Python 3
  2. Download the most recent .whl package from under dist/
  3. Install with pip: pip3 install lizard-0.<VERSION HERE>-py3-none-any.whl

If upgrading, see wiki.


Running 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 ~/lizard_data/.

You can call lizard r to refresh threads currently in the database, and see their status with lizard l. lizard rl combines these two steps. If you see threads with new activity (marked with ! or Y), you can open those in your default browser with lizard o (tip: have the browser running already before you do this).


1.1 (planned)

1.0 (in development)

Important note: The database schema will change with this version. Backup your database and get ready to migrate.

0.4 (current)

Command syntax changes:

  • Listing threads:
    • lizard la (list all) will produce the previous lizard l functionality.
    • lizard l will list only items that have had something interesting happen (reply or 404).
    • lizard rl will print the summary list.

Tor features:

  • lizard tor will now auto-open the tor captcha page for convenience. (#42)
  • When any web request receives a 403, a more informative message is printed. (#41)


  • lizard create command now working. (#43)

Older versions

See wiki.