-
Notifications
You must be signed in to change notification settings - Fork 0
Basic Usage: Running the Application
github-actions[bot] edited this page Feb 4, 2026
·
8 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
- Easy to visually track video progression and real-time cycling metrics during a cycling session
- Real-time logging is available directly within the application interface
- Easy to manage and edit multiple BSC sessions
Note that in order to run BLE Sync Cycle in GUI mode, the application must 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)
Running BLE Sync Cycle in CLI mode does not require any additional installation beyond building the application (see Building the Application).
The BLE Sync Cycle Project Wiki