# metarace-roadmeet
Timing and result application for UCI Part 2 Road Races,
UCI Part 5 Cyclo-Cross, criterium, road handicap and
ad-hoc time trial events.
## Usage
Choose meet folder and open:
$ roadmeet
Open an existing road meet:
$ roadmeet PATH
Create empty meet folder and open it:
$ roadmeet --create
Edit default configuration:
$ roadmeet --edit-default
## Time Trial Timing Modes & Options
### Impulse (Classic)
Chronometer impulses on channels C0 (start) and C1 (finish)
determine rider's elapsed time in the event.
Hardware setup:
- Tape switch or photo cell on start line connected to chronometer C0
- Tape switch or photo cell on finish line connected to chronometer C1
- Transponder loop ~10m before finish line
Meet configuration:
- Hardware -> Transponders: Decoder type/port [optional]
- Hardware -> Impulse: Timy serial port
OR
- Telegraph -> Timer: timertopic
- Telegraph -> Receive remote timer messages? Yes
Event configuration:
- Autotime: Match impulses to transponder? No
- Start Loop: null
- Finish Loop: null
- Finish Loop: Map trigger to start? No
- Start: Start times are strict? [optional]
In this mode, transponder readings will arm the finish line
for arrival of a finishing rider.
The start line can be manually operated, or if the "strict start"
option is set, start impulses will be automatically applied.
### Transponder
Rider finish times are determined by transponder passings
and start times are set by advertised start or transponder passing.
Hardware setup:
- Transponder loop on finish line
- Transponder loop just after start line (may also be finish line)
Meet configuration:
- Hardware -> Transponders: Decoder type/port
- Hardware -> Impulse: null
OR
- Telegraph -> Timer: timertopic
- Telegraph -> Receive remote timer messages? Yes
Event configuration:
- Autotime: Match impulses to transponder? No
- Start Loop: 1-8 [optional]
- Finish Loop: 1-8
- Finish Loop: Map trigger to start? No
- Start: Start times are strict? [optional]
**Note:** In this mode, precision is limited to 0.1s due
to hardware limitations and variation in transponder placement.
If strict start times are enabled, rider start times will
be set by transponder passing only when within ~5s of the
advertised start time.
The start and finish loops can be the same, for the case
where starters cross the finish loop as they depart the
start area.
### Autotime Transponder + Impulse
Start and finish times are set by chronometer impulses,
matched automatically to a corresponding transponder
passing.
Hardware setup:
- Tape switch or photo cell on start line connected to chronometer C0
- Tape switch or photo cell on finish line connected to chronometer C1
- Transponder loop on finish line
- Optional transponder loop just after start line (may also be finish line)
Meet configuration:
- Hardware -> Transponders: Decoder type/port
- Hardware -> Impulse: Timy serial port
OR
- Telegraph -> Timer: timertopic
- Telegraph -> Receive remote timer messages? Yes
Event configuration:
- Autotime: Match impulses to transponder? Yes
- Start Loop: 1-8 [optional, may be same as finish]
- Finish Loop: 1-8
- Finish Loop: Map trigger to start? No
- Start: Start times are strict? [Depends on start loop]
If start loop is set, strict start mode should be disabled.
If start loop is null, strict start should be enabled.
**Note:** In autotime mode, transponder passings must be received
after chronometer impulses. When using Tag Heuer/Chronelec
transponders, enable the "Detect Max" option to delay transponder
passings long enough to collect impulses first.
### Hybrid (Impulse start/transponder finish)
Hybrid mode is a special-case where a decoder's impulse trigger
input is used to supply a start time and transponder
readings are used on the finish line. This mode is especially useful
when a sterile finish line cannot be guaranteed, for short
time gaps or when riders complete a number of laps through a shared
finish.
Hardware setup:
- tape switch or photocell on start line - connected to decoder's
impulse input
- transponder loop on finish line
Meet configuration:
- Hardware -> Transponders: Decoder type/port
- Hardware -> Impulse: null
OR
- Telegraph -> Timer: timertopic
- Telegraph -> Receive remote timer messages? Yes
Event configuration:
- Autotime: Match impulses to transponder? No
- Start Loop: null
- Finish Loop: 1-8
- Finish Loop: Map trigger to start? Yes
- Start: Start times are strict? Yes
**Note:** In hybrid mode, a strict startlist is required to
allocate start impulses to starting riders automatically. If
strict start is not enabled, start line must be manually operated.
## Support
- Signal Group: [metarace](https://signal.group/#CjQKII2j2E7Zxn7dHgsazfKlrIXfhjgZOUB3OUFhzKyb-p_bEhBehsI65MhGABZaJeJ-tMZl)
- Github Issues: [issues](https://github.com/ndf-zz/metarace-roadmeet/issues)
## Requirements
- Python >= 3.11
- PyGObject
- Gtk >= 3.22
- metarace >= 2.1.10
- tex-gyre fonts (optional, recommended)
- evince (optional, recommended)
- rsync (optional)
- mosquitto (optional)
## Automated Installation
For semi-automated installation on common unix-like
desktop systems, download the metarace install script
and run with sh:
$ wget https://github.com/ndf-zz/metarace/raw/refs/heads/main/metarace-install.sh
$ sh metarace-install.sh
For installation on Windows systems, a powershell script
is provided to install metarace applications under a
WSL Debian container:
wget https://github.com/ndf-zz/metarace/raw/refs/heads/main/wsl-install.ps1
## Post-Installation Notes
Optionally configure defaults for new meets and library options:
$ ~/Documents/metarace/venv/bin/roadmeet --edit-default
### Gnome Desktop
By default, Gnome uses a system font which does not have
fixed-width digits. As a result, rolling times displayed
in roadmeet will jiggle left and right as the digits change,
and right-aligned time columns will not align correctly
at the decimal point.
To correct this, install gnome-tweaks and change the
system font to one with fixed-width digits eg:
Noto Sans Regular.
Debugging messages can be viewed using journalctl:
$ journalctl -f
### XFCE
The XFCE default window manager uses function keys to switch
workspaces, rendering them inaccessible to roadmeet.
To use these function keys in roadmeet (eg for
reports, arming and reset), first clear the relevant
window manager shortcuts.
Under Settings, Window Manager, Keyboard, locate the
"Workspace N" entries and clear the shortcut for each one by
selecting the "Clear" button.
Roadmeet can be configured to open meet folders in Thunar
by creating a custom action with appearance conditions
set to include "Directories". The action can then be
added to the toolbar or triggered from a context menu.
Following an automated install, you may need to log out
and back in for the menu entries to be properly updated.
Debugging messages are appended to ~/.xsession-errors,
view with tail:
$ tail -f ~/.xsession-errors
## Manual Installation
Install system requirements for your OS (See
[System-Specific Preparation](#system-specific-preparaton)
below) then prepare a metarace runtime directory
and virtual env as follows:
$ mkdir -p ~/Documents/metarace
$ python3 -m venv --system-site-packages ~/Documents/metarace/venv
Install roadmeet to the virtual env, or run from
source using one of the following methods:
### Install From PyPI With Pip
Use pip in your virtual env to download and install
roadmeet along with any required python packages
from the Python Package Index:
$ ~/Documents/metarace/venv/bin/pip3 install metarace-roadmeet
Create a new empty roadmeet:
$ ~/Documents/metarace/venv/bin/roadmeet --create
### Install From Wheel
Download the roadmeet wheel from github and verify signature:
$ wget https://github.com/ndf-zz/metarace-roadmeet/releases/download/v1.13.8/metarace_roadmeet-1.13.8-py3-none-any.whl
$ wget https://github.com/ndf-zz/metarace-roadmeet/releases/download/v1.13.8/metarace_roadmeet-1.13.8-py3-none-any.whl.asc
$ gpg --verify metarace_roadmeet-1.13.8-py3-none-any.whl.asc
Use pip in your virtual env to install the roadmeet wheel:
$ ~/Documents/metarace/venv/bin/pip3 install ./metarace_roadmeet-1.13.8-py3-none-any.whl
Create a new empty roadmeet:
$ ~/Documents/metarace/venv/bin/roadmeet --create
### Run From Source Tree
Activate the virtual env, optionally install
any required libraries, clone the repository
and run roadmeet directly:
$ source ~/Documents/metarace/venv/bin/activate
(venv) $ pip3 install metarace
(venv) $ git clone https://github.com/ndf-zz/metarace-roadmeet.git
(venv) $ cd metarace-roadmeet/src
(venv) $ python3 -m roadmeet
## System-Specific Preparation Notes
### Debian 11+, Ubuntu, Mint, MX (apt)
Install system requirements for roadmeet and metarace with apt:
$ sudo apt install python3-venv python3-pip
$ sudo apt install 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
$ sudo apt install python3-serial python3-paho-mqtt python3-dateutil python3-xlwt
Optionally add fonts, PDF viewer, rsync and MQTT broker:
$ sudo apt install fonts-texgyre fonts-noto evince rsync mosquitto
Add your user to the group **dialout**
in order to access serial ports:
$ sudo gpasswd -a "$USER" dialout
### Arch, Manjaro, EndeavourOS (pacman)
Install system requirements with pacman:
$ sudo pacman -S --needed python python-pip gtk3
$ sudo pacman -S --needed python-pyserial python-dateutil python-xlwt python-paho-mqtt python-gobject python-cairo
Optionally install pdf viewer, fonts, rsync and mqtt broker:
$ sudo pacman -S --needed noto-fonts tex-gyre-fonts evince rsync mosquitto
$ sudo systemctl enable mosquitto.service
Add your user to the group **uucp**
in order to access serial ports:
$ sudo gpasswd -a "$USER" uucp
### Gentoo Linux
Install required system libraries, or select a
suitable meta-package (eg XFCE):
# emerge --ask -n xfce-base/xfce4-meta x11-themes/gnome-themes-standard
Install required python packages:
# emerge --ask -n dev-libs/gobject-introspection dev-python/pygobject dev-python/python-dateutil dev-python/xlwt dev-python/pyserial dev-python/paho-mqtt
Install optional fonts, pdf viewer and MQTT broker:
# emerge --ask -n media-fonts/tex-gyre media-fonts/noto app-text/evince app-misc/mosquitto net-misc/rsync
Add your user to the group **dialout**
in order to access serial ports:
# gpasswd -a "username" dialout
### Alpine Linux (apk)
Setup a desktop environment, then add python requirements
with apk:
# apk add py3-pip py3-pyserial py3-dateutil py3-paho-mqtt py3-gobject3 py3-cairo
Install optional fonts, pdf viewer, rsync and MQTT broker:
# apk add font-noto evince rsync mosquitto
Install Tex Gyre fonts from Gust:
$ wget https://www.gust.org.pl/projects/e-foundry/tex-gyre/whole/tg2_501otf.zip
$ mkdir -p ~/.local/share/fonts
$ unzip -j -d ~/.local/share/fonts tg2_501otf.zip
$ fc-cache -f
Add your user to the group **dialout**
in order to access serial ports:
$ sudo gpasswd -a "$USER" dialout
### Fedora Linux (dnf)
Install system requirements:
$ sudo dnf install gtk3 gobject-introspection cairo-gobject
$ sudo dnf install python3-pip python3-cairo
$ sudo dnf install python3-pyserial python3-paho-mqtt python3-dateutil python-xlwt
Optionally add fonts, PDF viewer, rsync and MQTT broker:
$ sudo dnf install google-noto-sans-fonts google-noto-mono-fonts google-noto-emoji-fonts texlive-tex-gyre evince rsync mosquitto
$ sudo systemctl enable mosquitto.service
Add your user to the group **dialout**
in order to access serial ports:
$ sudo gpasswd -a "$USER" dialout
### Slackware
Install a desktop environment (eg XFCE),
python packages will be installed
as required by pip.
Note: Slackware does not ship evince with the XFCE
desktop, but sets it as the Gtk print preview application.
To enable print preview, install evince from slackbuilds,
or add an entry in ~/.config/gtk-3.0/settings.ini
to point to another application:
[Settings]
gtk-print-preview-command=xpdf %f
Install Tex Gyre fonts from Gust:
$ wget https://www.gust.org.pl/projects/e-foundry/tex-gyre/whole/tg2_501otf.zip
$ mkdir -p ~/.local/share/fonts
$ unzip -j -d ~/.local/share/fonts tg2_501otf.zip
$ fc-cache -f
Add your user to the group **dialout**
in order to access serial ports:
$ sudo gpasswd -a "$USER" dialout
### FreeBSD
Install a desktop environment (eg XFCE), then
install optional components with pkg:
# pkg install evince rsync mosquitto
Add user to group **dialer** in order to
access serial ports:
# pw group mod -n dialer -m op
Install Tex Gyre fonts from Gust:
$ wget https://www.gust.org.pl/projects/e-foundry/tex-gyre/whole/tg2_501otf.zip
$ mkdir -p ~/.local/share/fonts
$ unzip -j -d ~/.local/share/fonts tg2_501otf.zip
$ fc-cache -f
Note: Use callout serial devices for decoder access. For example,
a race result active decoder on the first USB serial port:
rru:/dev/cuaU0
### MacOS / Brew
[TBC]
### Windows / WSL
Install VirtualMachinePlatform and Windows Subsystem for Linux
with Powershell:
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All -NoRestart
wsl --install --no-distribution
Reboot computer, then prepare a Debian container:
wsl --install -d Debian
In the Debian shell, install wget, cups and thunar:
$ sudo apt-get install wget cups thunar
Add your user to the lpadmin group:
$ sudo gpasswd -a "$USER" "lpadmin
Download the installer and run with sh:
$ wget https://github.com/ndf-zz/metarace/raw/refs/heads/main/metarace-install.sh
$ sh metarace-install.sh
Raw data
{
"_id": null,
"home_page": null,
"name": "metarace-roadmeet",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "roadrace, timetrial, transponder",
"author": null,
"author_email": "Nathan Fraser <ndf-zz@6-v.org>",
"download_url": "https://files.pythonhosted.org/packages/bf/48/acb527aa060a50b012cac3f789ad2cfb81cd78a89b813226b02f13e3dc59/metarace_roadmeet-1.13.11.tar.gz",
"platform": null,
"description": "# metarace-roadmeet\n\nTiming and result application for UCI Part 2 Road Races,\nUCI Part 5 Cyclo-Cross, criterium, road handicap and\nad-hoc time trial events.\n\n![roadmeet screenshot](screenshot.png \"roadmeet\")\n\n\n## Usage\n\nChoose meet folder and open:\n\n\t$ roadmeet\n\nOpen an existing road meet:\n\n\t$ roadmeet PATH\n\nCreate empty meet folder and open it:\n\n\t$ roadmeet --create\n\nEdit default configuration:\n\n\t$ roadmeet --edit-default\n\n\n## Time Trial Timing Modes & Options\n\n### Impulse (Classic)\n\nChronometer impulses on channels C0 (start) and C1 (finish)\ndetermine rider's elapsed time in the event.\n\nHardware setup:\n\n - Tape switch or photo cell on start line connected to chronometer C0\n - Tape switch or photo cell on finish line connected to chronometer C1\n - Transponder loop ~10m before finish line\n\nMeet configuration:\n\n - Hardware -> Transponders: Decoder type/port [optional]\n - Hardware -> Impulse: Timy serial port\n\nOR\n\n - Telegraph -> Timer: timertopic\n - Telegraph -> Receive remote timer messages? Yes\n\nEvent configuration:\n\n - Autotime: Match impulses to transponder? No\n - Start Loop: null\n - Finish Loop: null\n - Finish Loop: Map trigger to start? No\n - Start: Start times are strict? [optional]\n\nIn this mode, transponder readings will arm the finish line\nfor arrival of a finishing rider.\n\nThe start line can be manually operated, or if the \"strict start\"\noption is set, start impulses will be automatically applied.\n\n\n### Transponder\n\nRider finish times are determined by transponder passings\nand start times are set by advertised start or transponder passing.\n\nHardware setup:\n\n - Transponder loop on finish line\n - Transponder loop just after start line (may also be finish line)\n\nMeet configuration:\n\n - Hardware -> Transponders: Decoder type/port\n - Hardware -> Impulse: null\n\nOR\n\n - Telegraph -> Timer: timertopic\n - Telegraph -> Receive remote timer messages? Yes\n\nEvent configuration:\n\n - Autotime: Match impulses to transponder? No\n - Start Loop: 1-8 [optional]\n - Finish Loop: 1-8\n - Finish Loop: Map trigger to start? No\n - Start: Start times are strict? [optional]\n\n**Note:** In this mode, precision is limited to 0.1s due\nto hardware limitations and variation in transponder placement.\n\nIf strict start times are enabled, rider start times will\nbe set by transponder passing only when within ~5s of the\nadvertised start time.\n\nThe start and finish loops can be the same, for the case\nwhere starters cross the finish loop as they depart the\nstart area.\n\n\n### Autotime Transponder + Impulse\n\nStart and finish times are set by chronometer impulses,\nmatched automatically to a corresponding transponder\npassing.\n\nHardware setup:\n\n - Tape switch or photo cell on start line connected to chronometer C0\n - Tape switch or photo cell on finish line connected to chronometer C1\n - Transponder loop on finish line\n - Optional transponder loop just after start line (may also be finish line)\n\nMeet configuration:\n\n - Hardware -> Transponders: Decoder type/port\n - Hardware -> Impulse: Timy serial port\n\nOR\n\n - Telegraph -> Timer: timertopic\n - Telegraph -> Receive remote timer messages? Yes\n\nEvent configuration:\n\n - Autotime: Match impulses to transponder? Yes\n - Start Loop: 1-8 [optional, may be same as finish]\n - Finish Loop: 1-8\n - Finish Loop: Map trigger to start? No\n - Start: Start times are strict? [Depends on start loop]\n\nIf start loop is set, strict start mode should be disabled.\nIf start loop is null, strict start should be enabled.\n\n**Note:** In autotime mode, transponder passings must be received\nafter chronometer impulses. When using Tag Heuer/Chronelec\ntransponders, enable the \"Detect Max\" option to delay transponder\npassings long enough to collect impulses first.\n\n### Hybrid (Impulse start/transponder finish)\n\nHybrid mode is a special-case where a decoder's impulse trigger\ninput is used to supply a start time and transponder\nreadings are used on the finish line. This mode is especially useful\nwhen a sterile finish line cannot be guaranteed, for short\ntime gaps or when riders complete a number of laps through a shared\nfinish.\n\nHardware setup:\n\n - tape switch or photocell on start line - connected to decoder's\n impulse input\n - transponder loop on finish line\n\nMeet configuration:\n\n - Hardware -> Transponders: Decoder type/port\n - Hardware -> Impulse: null\n\nOR\n\n - Telegraph -> Timer: timertopic\n - Telegraph -> Receive remote timer messages? Yes\n\nEvent configuration:\n\n - Autotime: Match impulses to transponder? No\n - Start Loop: null\n - Finish Loop: 1-8\n - Finish Loop: Map trigger to start? Yes\n - Start: Start times are strict? Yes\n\n**Note:** In hybrid mode, a strict startlist is required to\nallocate start impulses to starting riders automatically. If\nstrict start is not enabled, start line must be manually operated.\n\n## Support\n\n - Signal Group: [metarace](https://signal.group/#CjQKII2j2E7Zxn7dHgsazfKlrIXfhjgZOUB3OUFhzKyb-p_bEhBehsI65MhGABZaJeJ-tMZl)\n - Github Issues: [issues](https://github.com/ndf-zz/metarace-roadmeet/issues)\n\n\n## Requirements\n\n - Python >= 3.11\n - PyGObject\n - Gtk >= 3.22\n - metarace >= 2.1.10\n - tex-gyre fonts (optional, recommended)\n - evince (optional, recommended)\n - rsync (optional)\n - mosquitto (optional)\n\n\n## Automated Installation\n\nFor semi-automated installation on common unix-like\ndesktop systems, download the metarace install script\nand run with sh:\n\n\t$ wget https://github.com/ndf-zz/metarace/raw/refs/heads/main/metarace-install.sh\n\t$ sh metarace-install.sh\n\nFor installation on Windows systems, a powershell script\nis provided to install metarace applications under a\nWSL Debian container:\n\n\twget https://github.com/ndf-zz/metarace/raw/refs/heads/main/wsl-install.ps1\n\n\n## Post-Installation Notes\n\nOptionally configure defaults for new meets and library options:\n\n\t$ ~/Documents/metarace/venv/bin/roadmeet --edit-default\n\n\n### Gnome Desktop\n\nBy default, Gnome uses a system font which does not have\nfixed-width digits. As a result, rolling times displayed\nin roadmeet will jiggle left and right as the digits change,\nand right-aligned time columns will not align correctly\nat the decimal point.\n\nTo correct this, install gnome-tweaks and change the\nsystem font to one with fixed-width digits eg:\nNoto Sans Regular.\n\nDebugging messages can be viewed using journalctl:\n\n\t$ journalctl -f\n\n### XFCE\n\nThe XFCE default window manager uses function keys to switch\nworkspaces, rendering them inaccessible to roadmeet.\nTo use these function keys in roadmeet (eg for\nreports, arming and reset), first clear the relevant\nwindow manager shortcuts.\n\nUnder Settings, Window Manager, Keyboard, locate the\n\"Workspace N\" entries and clear the shortcut for each one by\nselecting the \"Clear\" button.\n\nRoadmeet can be configured to open meet folders in Thunar\nby creating a custom action with appearance conditions \nset to include \"Directories\". The action can then be\nadded to the toolbar or triggered from a context menu.\n\nFollowing an automated install, you may need to log out\nand back in for the menu entries to be properly updated.\n\nDebugging messages are appended to ~/.xsession-errors,\nview with tail:\n\n\t$ tail -f ~/.xsession-errors\n\n\n## Manual Installation\n\nInstall system requirements for your OS (See\n[System-Specific Preparation](#system-specific-preparaton)\nbelow) then prepare a metarace runtime directory\nand virtual env as follows:\n\n\t$ mkdir -p ~/Documents/metarace\n\t$ python3 -m venv --system-site-packages ~/Documents/metarace/venv\n\nInstall roadmeet to the virtual env, or run from\nsource using one of the following methods:\n\n\n### Install From PyPI With Pip\n\nUse pip in your virtual env to download and install\nroadmeet along with any required python packages\nfrom the Python Package Index:\n\n\t$ ~/Documents/metarace/venv/bin/pip3 install metarace-roadmeet\n\nCreate a new empty roadmeet:\n\n\t$ ~/Documents/metarace/venv/bin/roadmeet --create\n\n\n### Install From Wheel\n\nDownload the roadmeet wheel from github and verify signature:\n\n\t$ wget https://github.com/ndf-zz/metarace-roadmeet/releases/download/v1.13.8/metarace_roadmeet-1.13.8-py3-none-any.whl\n\t$ wget https://github.com/ndf-zz/metarace-roadmeet/releases/download/v1.13.8/metarace_roadmeet-1.13.8-py3-none-any.whl.asc\n\t$ gpg --verify metarace_roadmeet-1.13.8-py3-none-any.whl.asc\n\nUse pip in your virtual env to install the roadmeet wheel:\n\n\t$ ~/Documents/metarace/venv/bin/pip3 install ./metarace_roadmeet-1.13.8-py3-none-any.whl\n\nCreate a new empty roadmeet:\n\n\t$ ~/Documents/metarace/venv/bin/roadmeet --create\n\n\n### Run From Source Tree\n\nActivate the virtual env, optionally install\nany required libraries, clone the repository\nand run roadmeet directly:\n\n\t$ source ~/Documents/metarace/venv/bin/activate\n\t(venv) $ pip3 install metarace\n\t(venv) $ git clone https://github.com/ndf-zz/metarace-roadmeet.git\n\t(venv) $ cd metarace-roadmeet/src\n\t(venv) $ python3 -m roadmeet\n\n\n## System-Specific Preparation Notes\n\n### Debian 11+, Ubuntu, Mint, MX (apt)\n\nInstall system requirements for roadmeet and metarace with apt:\n\n\t$ sudo apt install python3-venv python3-pip\n\t$ sudo apt install 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\n\t$ sudo apt install python3-serial python3-paho-mqtt python3-dateutil python3-xlwt\n\nOptionally add fonts, PDF viewer, rsync and MQTT broker:\n\n\t$ sudo apt install fonts-texgyre fonts-noto evince rsync mosquitto\n\nAdd your user to the group **dialout**\nin order to access serial ports:\n\n\t$ sudo gpasswd -a \"$USER\" dialout\n\n\n### Arch, Manjaro, EndeavourOS (pacman)\n\nInstall system requirements with pacman:\n\n\t$ sudo pacman -S --needed python python-pip gtk3\n\t$ sudo pacman -S --needed python-pyserial python-dateutil python-xlwt python-paho-mqtt python-gobject python-cairo\n\nOptionally install pdf viewer, fonts, rsync and mqtt broker:\n\n\t$ sudo pacman -S --needed noto-fonts tex-gyre-fonts evince rsync mosquitto\n\t$ sudo systemctl enable mosquitto.service\n\nAdd your user to the group **uucp**\nin order to access serial ports:\n\n\t$ sudo gpasswd -a \"$USER\" uucp\n\n\n### Gentoo Linux\n\nInstall required system libraries, or select a\nsuitable meta-package (eg XFCE):\n\n\t# emerge --ask -n xfce-base/xfce4-meta x11-themes/gnome-themes-standard\n\nInstall required python packages:\n\n\t# emerge --ask -n dev-libs/gobject-introspection dev-python/pygobject dev-python/python-dateutil dev-python/xlwt dev-python/pyserial dev-python/paho-mqtt\n\nInstall optional fonts, pdf viewer and MQTT broker:\n\n\t# emerge --ask -n media-fonts/tex-gyre media-fonts/noto app-text/evince app-misc/mosquitto net-misc/rsync\n\nAdd your user to the group **dialout**\nin order to access serial ports:\n\n\t# gpasswd -a \"username\" dialout\n\n\n### Alpine Linux (apk)\n\nSetup a desktop environment, then add python requirements\nwith apk:\n\n\t# apk add py3-pip py3-pyserial py3-dateutil py3-paho-mqtt py3-gobject3 py3-cairo\n\nInstall optional fonts, pdf viewer, rsync and MQTT broker:\n\n\t# apk add font-noto evince rsync mosquitto\n\nInstall Tex Gyre fonts from Gust:\n\n\t$ wget https://www.gust.org.pl/projects/e-foundry/tex-gyre/whole/tg2_501otf.zip\n\t$ mkdir -p ~/.local/share/fonts\n\t$ unzip -j -d ~/.local/share/fonts tg2_501otf.zip\n\t$ fc-cache -f\n\nAdd your user to the group **dialout**\nin order to access serial ports:\n\n\t$ sudo gpasswd -a \"$USER\" dialout\n\n\n### Fedora Linux (dnf)\n\nInstall system requirements:\n\n\t$ sudo dnf install gtk3 gobject-introspection cairo-gobject\n\t$ sudo dnf install python3-pip python3-cairo\n\t$ sudo dnf install python3-pyserial python3-paho-mqtt python3-dateutil python-xlwt\n\nOptionally add fonts, PDF viewer, rsync and MQTT broker:\n\n\t$ sudo dnf install google-noto-sans-fonts google-noto-mono-fonts google-noto-emoji-fonts texlive-tex-gyre evince rsync mosquitto\n\t$ sudo systemctl enable mosquitto.service\n\nAdd your user to the group **dialout**\nin order to access serial ports:\n\n\t$ sudo gpasswd -a \"$USER\" dialout\n\n\n### Slackware\n\nInstall a desktop environment (eg XFCE),\npython packages will be installed\nas required by pip.\n\nNote: Slackware does not ship evince with the XFCE\ndesktop, but sets it as the Gtk print preview application.\nTo enable print preview, install evince from slackbuilds,\nor add an entry in ~/.config/gtk-3.0/settings.ini\nto point to another application:\n\n\t[Settings]\n\tgtk-print-preview-command=xpdf %f\n\nInstall Tex Gyre fonts from Gust:\n\n\t$ wget https://www.gust.org.pl/projects/e-foundry/tex-gyre/whole/tg2_501otf.zip\n\t$ mkdir -p ~/.local/share/fonts\n\t$ unzip -j -d ~/.local/share/fonts tg2_501otf.zip\n\t$ fc-cache -f\n\nAdd your user to the group **dialout**\nin order to access serial ports:\n\n\t$ sudo gpasswd -a \"$USER\" dialout\n\n\n### FreeBSD\n\nInstall a desktop environment (eg XFCE), then\ninstall optional components with pkg:\n\n\t# pkg install evince rsync mosquitto\n\nAdd user to group **dialer** in order to\naccess serial ports:\n\n\t# pw group mod -n dialer -m op\n\nInstall Tex Gyre fonts from Gust:\n\n\t$ wget https://www.gust.org.pl/projects/e-foundry/tex-gyre/whole/tg2_501otf.zip\n\t$ mkdir -p ~/.local/share/fonts\n\t$ unzip -j -d ~/.local/share/fonts tg2_501otf.zip\n\t$ fc-cache -f\n\nNote: Use callout serial devices for decoder access. For example,\na race result active decoder on the first USB serial port:\n\n\trru:/dev/cuaU0\n\n\n### MacOS / Brew\n\n[TBC]\n\n\n### Windows / WSL\n\nInstall VirtualMachinePlatform and Windows Subsystem for Linux\nwith Powershell:\n\n\tEnable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All -NoRestart\n\twsl --install --no-distribution\n\nReboot computer, then prepare a Debian container:\n\n\twsl --install -d Debian\n\nIn the Debian shell, install wget, cups and thunar:\n\n\t$ sudo apt-get install wget cups thunar\n\nAdd your user to the lpadmin group:\n\n\t$ sudo gpasswd -a \"$USER\" \"lpadmin\n\nDownload the installer and run with sh:\n\n\t$ wget https://github.com/ndf-zz/metarace/raw/refs/heads/main/metarace-install.sh\n\t$ sh metarace-install.sh\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Timing and result application for road cycling events",
"version": "1.13.11",
"project_urls": {
"homepage": "https://github.com/ndf-zz/metarace-roadmeet"
},
"split_keywords": [
"roadrace",
" timetrial",
" transponder"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c97f538a87eda769867fa4f4c7a5e2beec6b78beacda979c05cec53bd1d0cecb",
"md5": "884a1bb2ca19382345e79a54a3d2ea35",
"sha256": "668a200882c82861625e1755838e1f8a9f2f10b2498e02242ca8a826e46e0598"
},
"downloads": -1,
"filename": "metarace_roadmeet-1.13.11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "884a1bb2ca19382345e79a54a3d2ea35",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 124322,
"upload_time": "2025-07-27T12:18:20",
"upload_time_iso_8601": "2025-07-27T12:18:20.601366Z",
"url": "https://files.pythonhosted.org/packages/c9/7f/538a87eda769867fa4f4c7a5e2beec6b78beacda979c05cec53bd1d0cecb/metarace_roadmeet-1.13.11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "bf48acb527aa060a50b012cac3f789ad2cfb81cd78a89b813226b02f13e3dc59",
"md5": "ada3f75c17d58acef8a658307f351f73",
"sha256": "d9c1a27a53ade97e732d3e740e976eadff99d7cb680249109e6e2a8d50dcd929"
},
"downloads": -1,
"filename": "metarace_roadmeet-1.13.11.tar.gz",
"has_sig": false,
"md5_digest": "ada3f75c17d58acef8a658307f351f73",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 120485,
"upload_time": "2025-07-27T12:18:22",
"upload_time_iso_8601": "2025-07-27T12:18:22.462006Z",
"url": "https://files.pythonhosted.org/packages/bf/48/acb527aa060a50b012cac3f789ad2cfb81cd78a89b813226b02f13e3dc59/metarace_roadmeet-1.13.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-27 12:18:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ndf-zz",
"github_project": "metarace-roadmeet",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "metarace-roadmeet"
}
JSON
