Skip to content

lbormann/darts-hub

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

508 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

DARTS-HUB

Downloads

Darts-hub (formerly autodarts-desktop) manages several extension-apps for https://autodarts.io. It automatically downloads and updates those apps, provides configuration windows and launches extensions through a curated list of profiles.

Apps managed by darts-hub:

Disclaimer: Some apps could not be visible in your setup. The reason for that is that some apps are not available for your os.

COMPATIBILITY

Darts-hub supports all major platforms:

OS X64 X86 ARM ARM64
Windows βœ”οΈ βœ”οΈ βœ”οΈ βœ”οΈ
Linux βœ”οΈ βœ”οΈ βœ”οΈ
macOS βœ”οΈ βœ”οΈ

Darts-hub is built with Avalonia. check it out: https://docs.avaloniaui.net/

alt text alt text alt text alt text

HOW TO RUN

Single-Command (Linux, MacOS)

You can install darts-hub on a Linux system by using this single command. It will automatically download the latest version and configures it for autostart. You might have to install curl on your machine beforehand. You can do so with sudo apt install curl.

bash <(curl -sL get-add.arnes-design.de)

Step-by-step (Windows, Linux, MacOS)

Alternatively you can install darts-hub step by step.

  1. Create a new folder called "darts-hub" in your home directory.

  2. Download the appropiate zip-file. You can find it in the release section.

  3. Extract the zip-file to the new folder "darts-hub".

  4. Linux and MacOS: Execute the following commands in a terminal

    chmod +x ~/darts-hub/darts-hub
  5. MacOS: disable os-app-verification:

    sudo spctl --master-disable

    Unfortunately I couldn't find a proper way without doing this.

  6. Start the application by double-click darts-hub

HOW-TO-REMOVE

Single-Command (Linux, MacOS)

You can remove darts-hub by passing --uninstall flag as follows.

bash <(curl -sL get-add.arnes-design.de) --uninstall

Step-by-step (Windows, Linux, MacOS)

Alternatively you can uninstall darts-hub step by step.

  1. Remove the folder called "darts-hub" in your home directory.

  2. MacOS: enable os-app-verification:

    sudo spctl --master-enable

USAGE

Basics

Profiles representing different play-scenarios, whether you only want to use darts-caller or playing extern by using darts-extern. Every app in a profile can be marked for start by checking it. Apps that are mandantory for particular profile can't be unchecked. To start a selected profile click the button next to profile selection. On profile-start the application will check every included app for existence, installs it or updates it if it isn't up-to-date. If an app needs configuration, darts-hub will display a configuration window to organize that. Configuration is explained in the next section. To close a running app use the ecks-symbol. To see an apps output click the monitor-symbol that should appear after a short time since app-start. It shows full details of app events in realtime. You can also rename every app: use a right click for that; you can always return to the default name by entering an empty value.

App-configuration

Some Apps have mandatory configuration fields to work properly. You can also spot a mandatory field by asterik character (*) at the end of the particular field-name. To reset a field-value click on the rubber-symbol or the X behind an Argument to delete it. After Changing a configuration field, you have to restart the extension to apply changes.

Side note: a grayed out configuration field means, that it uses the default value of the app itself. The displayed value doesn't match the app`s default value necessarily. If you would like to know which default value will be used, have a look at specific app README.

Custom-apps

Imagine you could start your individual favorite apps. That is what custom-apps are made for. As an example: You could start OBS, to stream an autodarts game.. or trigger a Home-Assistant-hook to turn on your Autodarts-Build.. or just some lights.

Specific App-version

If you would like to stay on specific app-version, create an empty file called "my_version.txt" in particular app dir. That file will stop future app-updates, until you remove the file.

Disclaimer: If you're using a specific version of an app with configuration, like the darts-caller and the current darts-hub version doesn't fit to app`s configuration, there's a chance the app might not start properly.

TROUBLESHOOTING

App isn't starting at all

If you're running darts-hub on windows the affected app is probably classified as a virus. The easiest way to verify this is to close darts-hub. After that, add the main folder (darts-hub) as an exception for screening. Restart darts-hub and try to start the app.

Using CLI Features

Available Commands

Command Short Description
--help -h Shows help information
--version -v Shows version information (from Updater.cs)
--info Shows detailed application information
--system-info --sysinfo Shows system and environment information

Profile Management // NOT FINALLY IMPLEMENTED YET

Command Alias Description
--list-profiles --profiles Lists all available dart profiles

Backup & Restore πŸ†•

Command Description
--backup [name] Creates full backup (configuration, profiles, logs)
--backup-config [name] Creates configuration-only backup
--backup-list Lists all available backups
--backup-restore <file> Restores backup from file
--backup-cleanup [count] Deletes old backups (keeps the last N)

Testing Commands

Command Description
--test-updater Starts interactive updater test menu
--test-full Runs complete updater test suite
--test-version Tests version checking
--test-retry Tests retry mechanism
--test-logging Tests logging system

Runtime Options

Command Short Description
--verbose -vv Enables verbose logging (starts GUI)
--beta Enables beta tester mode (starts GUI)

For more information, run darts-hub --help or darts-hub -h in your terminal Or have a look at the command-line-interface.md file.

VIDEO INSTRUCTIONS

at the moment just in german:


Darts-Hub Installation & Setup Wizard 2025

IMAGE ALT TEXT HERE

CONFIGURATION EXPORT/IMPORT πŸ†•

Darts-hub now includes a powerful configuration export/import system that allows you to:

  • Backup your settings: Create full or partial backups of your extension configurations
  • Share configurations: Export settings to share with friends or the community
  • Move to new devices: Easily transfer your complete setup to a new computer
  • Test different setups: Create multiple configuration exports for different scenarios
  • Protect your credentials πŸ†•: Automatic prompt to exclude sensitive Autodarts credentials when exporting

Security Feature πŸ”’

When exporting configurations containing darts-caller, the system automatically prompts:

⚠ WARNING: Your configuration includes 'darts-caller'
   This extension contains sensitive Autodarts credentials

Do you want to EXCLUDE these credentials from export? (y/N):
  • Answer 'y' to safely share exports with others (excludes Email, Password, Board ID)
  • Answer 'n' for personal backups (includes everything)

Interactive CLI Tool (Windows)

For Windows users, we provide an easy-to-use interactive tool:

config-manager.bat - Double-click to open an interactive menu for:

  • Creating exports (Full / Extensions / Parameters)
  • Importing configurations (Merge / Replace modes)
  • Viewing available exports
  • Checking export information before importing
  • Built-in help and safety features

πŸ“– Config Manager Documentation

Interactive CLI Tool (Linux/macOS) πŸ†•

For Linux and macOS users:

config-manager.sh - Run the shell script for the same interactive experience:

chmod +x config-manager.sh  # First time only
./config-manager.sh

Features:

  • Complete feature parity with Windows version
  • Color-coded interface for better visibility
  • Automatic permission handling
  • All 15 menu options available
  • Backup & Restore, Testing, System Info

Command Line Interface

For advanced users and automation:

# Windows
.\darts-hub.exe --export my-backup
.\darts-hub.exe --export-ext darts-caller darts-wled
.\darts-hub.exe --import my-backup.json

# Linux/macOS
./darts-hub --export my-backup
./darts-hub --export-ext darts-caller darts-wled
./darts-hub --import my-backup.json

# List available exports
darts-hub --list-exports

For detailed documentation, see:

RESOURCES

About

Manager for https://autodarts.io extensions.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •