A command line (CLI) program for monitoring and downloading 8chan threads. Licensed under MIT.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Abrax 4bd7e34f0b Next version is 1.0, I've decided there's no reason to do 0.5 before that. 11 months ago
dist Committing months after the changes were made, I have no fucking clue what exactly I did. 11 months ago
lizard Committing months after the changes were made, I have no fucking clue what exactly I did. 11 months ago
lizard_tests Committing months after the changes were made, I have no fucking clue what exactly I did. 11 months ago
.gitignore Better packaging system (fixes #32, #33): 1 year ago
License.txt Now licensed under MIT. 2 years ago
README.md Next version is 1.0, I've decided there's no reason to do 0.5 before that. 11 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. 11 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.