Skip to content

LibreCrawl 2.51

Latest

Choose a tag to compare

@PhialsBasement PhialsBasement released this 10 Nov 01:19

LibreCrawl 2.51 makes installing and starting LibreCrawl work on Mac, Windows and Linux without Docker, and adds a step-by-step install guide for each.

Fixes

Start scripts

  • Mac and Linux: start-librecrawl.sh failed with externally-managed-environment on Homebrew Python and on recent Ubuntu, Debian and Arch, which refuse a system-wide pip install. It now installs into its own .venv in the LibreCrawl folder.
  • Windows: start-librecrawl.bat found the py launcher but never used it, and only worked if "Add Python to PATH" was ticked during the Python install. It now uses whichever Python it finds, with its own .venv too.
  • Both scripts now require Python 3.11+ and say so clearly, instead of failing later on an older Python.
  • Packages are checked on every start, so updating LibreCrawl brings in any new ones.
  • Docker: both scripts now check for Docker Compose and that Docker is actually running. If Docker Desktop is closed you get a message, instead of "LibreCrawl is running!" when it isn't.
  • start-librecrawl.sh is now executable straight after git clone, so it no longer fails with "permission denied".
  • Errors in the Windows script pause the window, so you can read them when you started it by double-click.

Windows

  • LibreCrawl crashed on startup when its output went to a file or pipe (logging to a file, running as a service), because Windows couldn't write the emoji in the startup warning. Output is now UTF-8.

Docs

  • The README's Quick Start now has step-by-step instructions for Windows, Mac and Linux, starting from installing Python.
  • The manual Python install uses a virtual environment and asks for Python 3.11+ (it said 3.8).

Testing

  • New CI runs on every push: the full fixture test suite, plus the start scripts on Windows, Mac (Apple Silicon) with both Homebrew and the python.org installer, and Ubuntu. Each start-script job only passes once LibreCrawl actually answers in the browser.

Full changelog: v2.50...v2.51