A command line (CLI) program for monitoring and downloading 8chan threads. Licensed under MIT.
Abrax 4bd7e34f0b Next version is 1.0, I've decided there's no reason to do 0.5 before that. 9 months ago
dist Committing months after the changes were made, I have no fucking clue what exactly I did. 9 months ago
lizard Committing months after the changes were made, I have no fucking clue what exactly I did. 9 months ago
lizard_tests Committing months after the changes were made, I have no fucking clue what exactly I did. 9 months ago
.gitignore Better packaging system (fixes #32, #33): 1 year ago
License.txt Now licensed under MIT. 1 year ago
README.md Next version is 1.0, I've decided there's no reason to do 0.5 before that. 9 months ago
build.sh Better packaging system (fixes #32, #33): 1 year ago
setup.py Next version is 1.0, I've decided there's no reason to do 0.5 before that. 9 months ago

README.md

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.

Installation

Linux

  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.

Usage

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).

Changelog

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)

Bugfixes:

  • lizard create command now working. (#43)

Older versions

See wiki.