metarace-ttstart


Namemetarace-ttstart JSON
Version 1.0.2 PyPI version JSON
download
home_pageNone
SummaryTime Trial Start Console
upload_time2025-07-20 05:01:23
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseNone
keywords tt start
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # metarace-ttstart

Time trial start console application. Includes time of day,
rider number, rider name, a 30 second count-down and audible
start beeps.

![ttstart screenshot](screenshot.png "ttstart")

For battery operated terminals, the screen can be set to dim
in between starters.

## Configuration

Configuration is via metarace sysconf section 'ttstart' with the
following keys:

key           | (type) description [default]
---           | ---
topic         | (string) telegraph topic for start list updates [startlist]
fullscreen    | (boolean) run application fullscreen after initialisation
backlightdev  | (string) sysfs path to backlight device [null] (1) eg: /sys/class/backlight/acpi_video0
backlightlow  | (float) dimmed backlight level between starters [0.25]
backlighthigh | (float) backlight level during countdown [1.0]
startlist     | (string) filename for a csv startlist file [startlist.csv]
syncthresh    | (float) maximum allowed audio de-sync in seconds [0.12] (2)

Notes:

   1.  The backlight brightness file must be writable in order
       for dimming to work
   2.  The acoustic start signal is terminated if it is not playing
       in sync with the displayed countdown.

## Remote Control

ttstart connects to telegraph and subscribes to the topic nominated.
To re-configure the start list, publish a JSON encoded array of arrays
with the following columns:

   - start time (string), required
   - rider number (string), optional
   - rider series (string), ignored
   - rider name (string), optional

For example:

	[["9h15:00","","","[Event Start]"], ["9h16:00","1","","First RIDER"]]


## Requirements

   - Python >= 3.11
   - Gtk >= 3.0
   - metarace >= 2.1.14
   - tex-gyre fonts
   - gstreamer alsa plugins

Note: Some 32 bit systems (notably Intel Atom Toughbooks) will not
play audio with the default Debian desktop installation.
The workaround is to remove pulseaudio and use alsa directly:

	$ sudo apt remove 'pulseaudio*'

## Installation

Use shared installer from metarace to collect requirements
and install with roadmeet and trackmeet:

	$ wget https://github.com/ndf-zz/metarace/raw/refs/heads/main/metarace-install.sh
	$ sh metarace-install.sh

Alternatively, install system requirements and use pip:

	$ sudo apt-get install python3-venv python3-pip python3-cairo \
	python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-rsvg-2.0 \
	gir1.2-pango-1.0 gir1.2-gstreamer-1.0 gstreamer1.0-alsa tex-gyre
	$ mkdir -p ~/Documents/metarace
	$ python3 -m venv --system-site-packages ~/Documents/metarace/venv
	$ ~/Documents/metarace/venv/bin/pip install metarace-ttstart
	$ ~/Documents/metarace/venv/bin/ttstart

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "metarace-ttstart",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "TT, start",
    "author": null,
    "author_email": "Nathan Fraser <ndf-zz@6-v.org>",
    "download_url": "https://files.pythonhosted.org/packages/9d/64/33d0f54a422853e53caa56b97435e2acb02318339b6849645dcc482746bb/metarace_ttstart-1.0.2.tar.gz",
    "platform": null,
    "description": "# metarace-ttstart\n\nTime trial start console application. Includes time of day,\nrider number, rider name, a 30 second count-down and audible\nstart beeps.\n\n![ttstart screenshot](screenshot.png \"ttstart\")\n\nFor battery operated terminals, the screen can be set to dim\nin between starters.\n\n## Configuration\n\nConfiguration is via metarace sysconf section 'ttstart' with the\nfollowing keys:\n\nkey           | (type) description [default]\n---           | ---\ntopic         | (string) telegraph topic for start list updates [startlist]\nfullscreen    | (boolean) run application fullscreen after initialisation\nbacklightdev  | (string) sysfs path to backlight device [null] (1) eg: /sys/class/backlight/acpi_video0\nbacklightlow  | (float) dimmed backlight level between starters [0.25]\nbacklighthigh | (float) backlight level during countdown [1.0]\nstartlist     | (string) filename for a csv startlist file [startlist.csv]\nsyncthresh    | (float) maximum allowed audio de-sync in seconds [0.12] (2)\n\nNotes:\n\n   1.  The backlight brightness file must be writable in order\n       for dimming to work\n   2.  The acoustic start signal is terminated if it is not playing\n       in sync with the displayed countdown.\n\n## Remote Control\n\nttstart connects to telegraph and subscribes to the topic nominated.\nTo re-configure the start list, publish a JSON encoded array of arrays\nwith the following columns:\n\n   - start time (string), required\n   - rider number (string), optional\n   - rider series (string), ignored\n   - rider name (string), optional\n\nFor example:\n\n\t[[\"9h15:00\",\"\",\"\",\"[Event Start]\"], [\"9h16:00\",\"1\",\"\",\"First RIDER\"]]\n\n\n## Requirements\n\n   - Python >= 3.11\n   - Gtk >= 3.0\n   - metarace >= 2.1.14\n   - tex-gyre fonts\n   - gstreamer alsa plugins\n\nNote: Some 32 bit systems (notably Intel Atom Toughbooks) will not\nplay audio with the default Debian desktop installation.\nThe workaround is to remove pulseaudio and use alsa directly:\n\n\t$ sudo apt remove 'pulseaudio*'\n\n## Installation\n\nUse shared installer from metarace to collect requirements\nand install with roadmeet and trackmeet:\n\n\t$ wget https://github.com/ndf-zz/metarace/raw/refs/heads/main/metarace-install.sh\n\t$ sh metarace-install.sh\n\nAlternatively, install system requirements and use pip:\n\n\t$ sudo apt-get install python3-venv python3-pip python3-cairo \\\n\tpython3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-rsvg-2.0 \\\n\tgir1.2-pango-1.0 gir1.2-gstreamer-1.0 gstreamer1.0-alsa tex-gyre\n\t$ mkdir -p ~/Documents/metarace\n\t$ python3 -m venv --system-site-packages ~/Documents/metarace/venv\n\t$ ~/Documents/metarace/venv/bin/pip install metarace-ttstart\n\t$ ~/Documents/metarace/venv/bin/ttstart\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Time Trial Start Console",
    "version": "1.0.2",
    "project_urls": {
        "homepage": "https://github.com/ndf-zz/metarace-ttstart"
    },
    "split_keywords": [
        "tt",
        " start"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "3f35dc9c11e2f09ff7173eb2d8860a0325d70269c9afd167b5d9c2418d5dfd6f",
                "md5": "7ccce1fd0b3e050f95764cc4809ab2ca",
                "sha256": "0f77f93a4eba17e7d62427ed0742e69df5aa4cccf3d6e1563db5f7c31d2d2d44"
            },
            "downloads": -1,
            "filename": "metarace_ttstart-1.0.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7ccce1fd0b3e050f95764cc4809ab2ca",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 251602,
            "upload_time": "2025-07-20T05:01:21",
            "upload_time_iso_8601": "2025-07-20T05:01:21.291108Z",
            "url": "https://files.pythonhosted.org/packages/3f/35/dc9c11e2f09ff7173eb2d8860a0325d70269c9afd167b5d9c2418d5dfd6f/metarace_ttstart-1.0.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "9d6433d0f54a422853e53caa56b97435e2acb02318339b6849645dcc482746bb",
                "md5": "7363bf9cadf88d43c1b62a40cb019c51",
                "sha256": "c4ab32bce933615b7ebb74ff5f4bb47565c2f2a09ce6f02e56218a6c2995059c"
            },
            "downloads": -1,
            "filename": "metarace_ttstart-1.0.2.tar.gz",
            "has_sig": false,
            "md5_digest": "7363bf9cadf88d43c1b62a40cb019c51",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 242942,
            "upload_time": "2025-07-20T05:01:23",
            "upload_time_iso_8601": "2025-07-20T05:01:23.548074Z",
            "url": "https://files.pythonhosted.org/packages/9d/64/33d0f54a422853e53caa56b97435e2acb02318339b6849645dcc482746bb/metarace_ttstart-1.0.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-20 05:01:23",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "ndf-zz",
    "github_project": "metarace-ttstart",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "metarace-ttstart"
}
        
Elapsed time: 2.62574s