Home / Documentation

Documentation

Thyron documentation

Thyron is a free music player for local audio files on Windows, macOS, Linux, Android and iOS. Playback, search and playlists work offline without an account or subscription. Music is added from your own files; the app does not include a streaming catalog.

Installation

Select an operating system. Each tab lists the installer format, installation steps, and how to add audio files.

Get Started

Windows

.exe installer
  1. 01

    Download the installer

    Download the .exe file using the link below.

  2. 02

    Install the application

    Open the downloaded file and follow the installer instructions.

  3. 03

    Add a folder

    Launch Thyron. In Storage, select Add storage folder and choose a folder containing audio files.

Get Started

macOS

.dmg disk image
  1. 01

    Download the disk image

    Download the .dmg file and open it in Finder.

  2. 02

    Install in Applications

    Drag Thyron into Applications, then launch it from that folder.

  3. 03

    Add a folder

    In Storage, select Add storage folder and choose a local folder containing audio files. Allow file access if prompted.

Get Started

Linux

.deb · Debian / Ubuntu
  1. 01

    Download the package

    Download thyron.deb. This installer is intended for distributions that support Debian packages.

  2. 02

    Install the package

    Open a terminal in the folder containing the downloaded file and run the command below.

    sudo apt install ./thyron.deb
  3. 03

    Launch the application

    Open Thyron from the application menu. Add a folder containing audio files in Storage.

Get Started

Android

.apk installer
  1. 01

    Download the APK

    Download the .apk file to the device and open it.

  2. 02

    Install the application

    If Android requests permission, allow installation for the browser or file manager used to open the APK. Then complete the installation.

  3. 03

    Add a folder

    Open Storage → Add storage folder. Grant file access and select a folder in the device’s internal storage.

Get Started

iOS

App Store · iPhone / iPad
  1. 01

    Open the App Store page

    Open the App Store link below on an iPhone or iPad.

  2. 02

    Install the application

    Tap Get or the download icon, wait for installation to finish, then open Thyron.

  3. 03

    Import audio files

    In Storage, tap Import audio files. Select files in the system picker. Thyron copies them into app storage.

Adding audio files

The library is built from files in the selected storage. Multiple folders can be connected and selected in Storage. Each storage has its own tracks and playlists.

  1. On desktop and Android, open Storage → Add storage folder. Select a folder containing audio files. The app scans supported files and reads track names, artists, and artwork from their metadata.
  2. On iOS, open Storage → Import audio files and select files in the system picker. They are copied into the app’s internal storage.
  3. Tracks appear in the library after scanning. On desktop, tracks and playlists are displayed side by side. On a phone, swipe horizontally to switch between them.
Desktop and Android read files from the selected folder. On iOS, files are copied into app storage. Tracks appear in the library after scanning.

Creating and editing playlists

A playlist contains selected tracks from the current storage. Tracks can be added to an existing playlist or to a new playlist created during the same operation.

  1. Press and hold a track to enter selection mode. Click other tracks or drag down with the mouse button or finger held down. Then select Add to playlist.
  2. Select an existing playlist. To create one, choose Add playlist, enter a name, and confirm with OK.
  3. Clicking a playlist name starts playback of its tracks. The three-dot menu opens its contents, where individual tracks can be played or removed from the playlist.
Creating a playlist: select tracks, enter a name, and confirm. Clicking the playlist name starts playback; the three-dot menu opens its contents.

Playback controls

The playback panel is at the bottom of the window. It shows the current track and playback position, with controls for skipping tracks, pausing, shuffle, and repeat.

  1. Select a track or playlist to start playback. Use the center button to pause or resume and the adjacent buttons to skip to the previous or next track.
  2. Move the progress slider to seek within the track. Shuffle changes the track order; repeat enables repeated playback.
  3. On desktop, hover over the speaker icon to adjust volume. When the main window is closed, controls remain available in the tray mini-player. Open Thyron restores the main window.
The progress bar sets the playback position. The tray mini-player provides playback controls when the main window is closed.

Keyboard controls (VIM mode)

VIM mode moves focus between tracks and playlists using the keyboard. Moving focus alone does not change the playing track.

Desktop versions use Cmd on macOS and Ctrl on Windows and Linux.

Keyboard shortcut Action
Cmd / Ctrl + H / J / K / L Move focus left / down / up / right
Cmd / Ctrl + Space Play the focused track or playlist
Space Pause / resume playback
Cmd / Ctrl + F Focus search
Cmd / Ctrl + R Toggle repeat
Esc Leave the search field

Typing sends text to the search field. While that field is focused, Space inserts a space instead of toggling playback.

Gray marks keyboard focus. Mint marks the playing track.

Local network synchronization

Transfers are started manually between two devices on the same local network. The leading device sends missing tracks to the receiving device, and playlists are merged.

  1. Connect both devices to the same local network. Open Thyron and select a storage on each device.
  2. On the receiving device, open Settings → Local network sync → Receive. Wait for Ready to receive and keep the window open.
  3. On the leading device, open Settings → Local network sync → Synchronize. Select Find devices, then Synchronize beside the intended device. Keep both apps open until the transfer finishes.
The receiving device must show “Ready to receive”. It then appears in the list of discovered devices on the leading device.

Language and interface scale

The menu icon beside search opens Settings. The panel contains language and scale settings, local network sync, and About.

  1. In Language, select English, Russian, Spanish, Chinese, or Hindi. The application language is configured separately from the website language.
  2. Use Interface scale to select the size of text and controls.
  3. Open About to view application information, the privacy policy, and support contact options.
The menu icon beside search opens Settings. The current storage is linked at the bottom of the panel.

Supported audio formats

The library scans MP3, M4A, AAC, ALAC, FLAC, OGG, WAV, and AIFF files.

Platforms Audio files
Windows · Linux · Android MP3, M4A, AAC, ALAC, FLAC, OGG, WAV, AIFF
macOS · iOS MP3, M4A, AAC, ALAC, FLAC, WAV, AIFF

Support

If tracks do not appear, complete the checks below. If the issue persists, submit a bug report on GitHub or contact support by email.

Tracks are missing from the library

  • Check that the selected folder contains supported audio files.
  • Allow Thyron access to media or files when your device asks for permission.
  • Select the music folder again if it was moved, renamed, or disconnected.
  • Close and reopen Thyron after adding new music files.

Bug reports and feature requests

Report bugs and request features in the Thyron Feedback repository on GitHub. Include the steps to reproduce the issue, the expected result, and the actual result.

Open Thyron Feedback on GitHub

Contact

For email support, include a description of the issue, the Thyron version, device model, and operating system version. Support address: