Repository navigation
Running the Application
github-actions[bot] edited this page Sep 30, 2026
·
9 revisions
BLE Sync Cycle can be run in two application modes: GUI or CLI.
In GUI (graphical user interface) mode, the application is started and run like any other graphical application. Some benefits of running in GUI Mode include:
- Easy to start (available from the desktop environment's application menu)
- Easy to visually track video progression and real-time cycling metrics during a cycling session
- Real-time presentation of session metrics, including ride time
- Optional auto-resume feature allows you to continue a session from where you left off
- Real-time logging is available directly within the application interface
- Easy to edit and manage multiple BSC sessions
Note that in order to run BLE Sync Cycle in GUI Mode, the application must first be installed as a desktop application (see Installing the Application) for details.
In CLI (command line interface) mode, the application is started from the command line within a terminal. Some benefits of running in CLI Mode include:
- Easy to run the application from anywhere within a terminal
- The application can be configured with optional command-line configuration flags
- Real-time logging is available (outputs to
stdout) - Easy to shutdown the application (CTRL+C, which sends a
SIGINTsignal to the application)
The BLE Sync Cycle Project Wiki