tubelight 1.4.0

A smart browser-based log viewer for local app logs.

tubelight

A smart browser-based log viewer for local app logs.

Tubelight turns any local file into a searchable, live-updating table in your browser. It is ideal for development, debugging, and monitoring your app logs without needing tail -f.

Features

• Render local log files in a polished browser UI
• Search by message, module, file path, or log contents
• Filter by level: DEBUG, INFO, SUCCESS, WARNING, ERROR, CRITICAL
• Date-range filtering with start/end datetime controls
• Auto-scroll to newest logs when live mode is enabled
• Click any row to expand raw log details
• Simple CLI and environment variable configuration
• Ready for pip packaging and distribution

Installation

Install the package from source or once published on PyPI.

From source

uv run python -m pip install -e .

From PyPI

pip install tubelight

Makefile

A Makefile is included for common workflows:

make build
make publish
make bump-patch
make bump-minor
make bump-major
make set-version VERSION=2.0.0

Quick start

Run the viewer with the default example.log in your current directory:

tubelight

Or point it at a custom log file:

tubelight --log-file /path/to/your/app.log

You can also use the environment variable:

LOG_FILE=/path/to/your/app.log tubelight

Change the port if needed:

tubelight --port 8080

Filter the current view by date range:

tubelight --log-file /path/to/your/app.log

Then use the start/end controls in the browser to restrict the log window to a specific time range.

Open the viewer:

http://127.0.0.1:5111

Packaging for pip

Build source and wheel distributions:

uv run python -m pip install build
uv run python -m build

Publish to PyPI using Twine:

uv run python -m pip install twine
uv run python -m twine upload dist/*

Testing

Run the included smoke tests:

uv run python -m unittest

Project layout

• tubelight/ — package source
• tubelight/static/ — browser UI assets
• app.py — local launch wrapper
• pyproject.toml — packaging metadata
• README.md — documentation
• LICENSE — MIT license

Contributing

Contributions are welcome. Open an issue or send a pull request with:

• bug reports
• UX improvements
• log format support
• authentication / multi-user features

License

MIT