metarace-ttstart


Namemetarace-ttstart JSON
Version 1.0.1 PyPI version JSON
download
home_page
SummaryTime Trial Start Console
upload_time2023-06-28 03:23:15
maintainer
docs_urlNone
author
requires_python>=3.9
licenseMIT
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.9
   - Gtk >= 3.0
   - metarace >= 2.1.1
   - 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

### Debian 11+

Install system requirements for ttstart and metarace with apt:

	$ sudo apt install python3-venv python3-pip python3-cairo python3-gi python3-gi-cairo
	$ sudo apt install 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
	$ sudo apt install python3-serial python3-paho-mqtt python3-dateutil python3-xlwt

If not already created, add a virtualenv for metarace packages:

	$ mkdir -p ~/Documents/metarace
	$ python3 -m venv --system-site-packages ~/Documents/metarace/venv

Activate the virtualenv and install ttstart with pip:

	$ source ~/Documents/metarace/venv/bin/activate
	(venv) $ pip3 install metarace-ttstart


            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "metarace-ttstart",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "",
    "keywords": "TT,start",
    "author": "",
    "author_email": "Nathan Fraser <ndf-zz@6-v.org>",
    "download_url": "https://files.pythonhosted.org/packages/8a/fd/18920a2c73565ec9257ef46ead9b360e4c18d4ead1038a1552c4ed2f6b12/metarace-ttstart-1.0.1.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.9\n   - Gtk >= 3.0\n   - metarace >= 2.1.1\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\n### Debian 11+\n\nInstall system requirements for ttstart and metarace with apt:\n\n\t$ sudo apt install python3-venv python3-pip python3-cairo python3-gi python3-gi-cairo\n\t$ sudo apt install 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\n\t$ sudo apt install python3-serial python3-paho-mqtt python3-dateutil python3-xlwt\n\nIf not already created, add a virtualenv for metarace packages:\n\n\t$ mkdir -p ~/Documents/metarace\n\t$ python3 -m venv --system-site-packages ~/Documents/metarace/venv\n\nActivate the virtualenv and install ttstart with pip:\n\n\t$ source ~/Documents/metarace/venv/bin/activate\n\t(venv) $ pip3 install metarace-ttstart\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Time Trial Start Console",
    "version": "1.0.1",
    "project_urls": {
        "homepage": "https://github.com/ndf-zz/metarace-ttstart"
    },
    "split_keywords": [
        "tt",
        "start"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "0b2adc924ce126e68faf27c73c8624ee1e12443e15d30eabc1d611c16f1467b2",
                "md5": "048bc5d218ede74b9f542aca7fcf22c5",
                "sha256": "44b7af270aea5c97d3084fb9e9811a6b7406baa34c0dd02c93e8a2ac3d01413a"
            },
            "downloads": -1,
            "filename": "metarace_ttstart-1.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "048bc5d218ede74b9f542aca7fcf22c5",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 251503,
            "upload_time": "2023-06-28T03:23:11",
            "upload_time_iso_8601": "2023-06-28T03:23:11.887889Z",
            "url": "https://files.pythonhosted.org/packages/0b/2a/dc924ce126e68faf27c73c8624ee1e12443e15d30eabc1d611c16f1467b2/metarace_ttstart-1.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8afd18920a2c73565ec9257ef46ead9b360e4c18d4ead1038a1552c4ed2f6b12",
                "md5": "88cfa9e30c19b089b867d436716fc0aa",
                "sha256": "f8ed0d275867ede50a3a10912200c2720d9c6e210e9624256031499b247adc63"
            },
            "downloads": -1,
            "filename": "metarace-ttstart-1.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "88cfa9e30c19b089b867d436716fc0aa",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 242857,
            "upload_time": "2023-06-28T03:23:15",
            "upload_time_iso_8601": "2023-06-28T03:23:15.954125Z",
            "url": "https://files.pythonhosted.org/packages/8a/fd/18920a2c73565ec9257ef46ead9b360e4c18d4ead1038a1552c4ed2f6b12/metarace-ttstart-1.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-06-28 03:23:15",
    "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: 0.08578s