Projektor pesmi (Song Projector)

A Tkinter-based song projector application with optional Flask web interface for remote control.

Features

• Tkinter GUI: Full-screen song display with customizable fonts, colors, and sizing
• Song Database: SQLite database with lyrics and metadata
• Web Interface (optional): Control the projector via web browser
  • Load songs by number or search by title
  • Navigate between lyrics pages
  • Toggle uppercase display
  • Clear/dim the screen
• Keyboard Shortcuts: Quick navigation and screen control
• Settings: JSON-based configuration for fonts, colors, and display options

Project Structure

Projekcija/
├── projector.py           # Main Tkinter application
├── nastavitve.py          # Settings defaults and initialization
├── add_song.py            # Utility to import songs into database
├── songs.db               # SQLite database with lyrics
├── settings.json          # User configuration
├── web/                   # Flask web server package
│   ├── __init__.py
│   ├── server.py          # Flask app and API endpoints
│   ├── static/            # Web assets
│   │   ├── styles.css
│   │   └── script.js
│   └── templates/
│       └── index.html
├── tests/                 # Test suite
│   ├── test_api.py
│   ├── test_integration.py
│   └── test_mock.py
└── startup.bat            # Windows batch launcher

Installation

Requirements

• Python 3.8+
• Flask (for web interface)
• sqlite3 (included with Python)

Setup

# Install Flask
pip install flask

# Create or import songs into database (optional)
python add_song.py

Usage

Launch the Application

python projector.py

Or use the batch file:

startup.bat

Keyboard Shortcuts

• Enter: Load song by number (when typing in keyboard mode)
• + (plus): Clear/dim the screen
• - (minus): Previous page
• / (slash): Search songs by title

Configuration

Edit settings.json to customize:

• Font name, size, and color
• Background color
• Display width percentage
• web_port: Set to a port number (e.g., 5000) to enable web interface, or 0 to disable

Example settings.json:

{
    "font_name": "Times New Roman",
    "font_size": 32,
    "fg_color": "#FFFFFF",
    "bg_color": "#000000",
    "screen_width_percent": 60,
    "font_bold": true,
    "web_port": 5000
}

Web Interface

If web_port is configured and > 0, the web interface opens automatically:

http://127.0.0.1:<web_port>/

Features:

• Load by Number: Input song ID and press "Naloži"
• Search: Find songs by keyword
• Navigation: Next/Previous buttons to flip pages
• Case Toggle: "velikE črke" button for uppercase
• Clear Screen: "Zatemniti ekran" button to dim display

Testing

Run the integration test to verify the web server:

python -m tests.test_integration

This starts a mock projector, launches the Flask server, and exercises all API endpoints.

Architecture

Database Schema

• songs table: id, title, lyrics
• Read-only mode (no modifications via web interface)

API Endpoints

• GET / – HTML interface
• GET /api/state – Current projector state (text, page, navigation flags)
• POST /api/load_song – Load a song
• POST /api/next_page – Next page
• POST /api/prev_page – Previous page
• POST /api/clear_screen – Clear display
• POST /api/toggle_caps – Toggle uppercase
• POST /api/search_songs – Find songs by title

Threading

• Web server runs in a daemon thread
• Safe SQLite access with check_same_thread=False

Notes

• The web interface is optional; disable it by setting web_port: 0 in settings
• HTML, CSS, and JavaScript are stored in separate files under web/
• For production deployment, use a WSGI server (Gunicorn, uWSGI) instead of Flask development server
• Songs database is read-only via web interface; add songs using admin tools or direct SQL

License

[Add your license here]