LibreSignage

LibreSignage is an open-source digital signage web application built with Flask. The project uses Flask's application factory pattern and blueprints so features can be developed and tested independently.

Requirements

• Python 3.10 or newer
• uv (recommended) or another Python package installer

Development

Clone the repository, install the locked development environment, and start Flask:

uv sync --dev
uv run flask --app libresignage run --debug

Then open http://127.0.0.1:5000.

Run the quality checks:

uv run pytest
uv run ruff check .
uv build
uv run twine check dist/*

The package also exposes libresignage:create_app for WSGI servers:

from libresignage import create_app

app = create_app()

Building and publishing

Build both distribution formats with uv build. GitHub Actions validates every push and pull request. Creating a GitHub release triggers the PyPI publishing workflow, which uses PyPI Trusted Publishing and a protected pypi GitHub environment.

License

LibreSignage is distributed under the MIT License. See LICENSE.