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. After scanning, Library opens with separate Tracks and Playlists panels on desktop. On a phone, use the tabs or swipe horizontally. To switch storage, open Settings → Storage.
Desktop and Android read files from the selected folder. On iOS, files are copied into app storage. Tracks appear in the library after scanning.

Editing track metadata

Change a track’s title, artist and cover in Thyron. Use the editor when tags are missing or the information in a file needs correcting.

  1. Hold one track in the library and click the pencil in the selection toolbar. The button appears only when exactly one track is selected.
  2. In Edit track, fill in Title and Artist. You can also choose, replace or remove the cover.
  3. Click Save. Metadata is written to the audio file in the current storage; the sound stays unchanged. Cancel closes the editor without saving.

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. Hold a track to start selecting. Click other tracks or drag your mouse or finger down without releasing. A selection count and actions for adding to a playlist, sharing, deleting, and cancelling appear. On phones, they replace the library title while search, tabs, and the list stay in place. On desktop, the actions appear in the panel header; hover over an icon to see its label. When one track is selected, the pencil opens the metadata editor.
  2. Click Add to playlist. Find an existing playlist using Search playlists and select it. To create one, expand New playlist, enter a name, and click Create.
  3. Click a playlist to play its tracks. The three dots open its contents and a separate search field. You can play a track, hold to select several tracks, and choose Remove from playlist. The three-dot menu inside a playlist also provides rename and delete actions. Hold a playlist to select it. The toolbar offers sharing, deleting, and cancelling selection; renaming is available when one playlist is selected.
Creating a playlist: select tracks, enter a name, and confirm. Clicking the playlist name starts playback; the three-dot menu opens its contents.

Playlist covers

You can assign a custom cover to a playlist. It appears in the playlist list and in the header when you open the playlist.

  1. Open a playlist's contents using the three dots in the library. In the three-dot menu inside the playlist, select Choose cover and pick an image from your device.
  2. To use a different image, open the same menu and select Change cover.
  3. Remove cover restores the default icon. The playlist and its tracks are kept.

Thyron saves a copy of the image in storage, crops it to a square from the center, and reduces it to no more than 512×512 pixels. The original file stays unchanged.

Covers are transferred with playlists during full sync and when you Share selected playlists. The app compares file hashes: if the receiving device already has the same cover, it is not downloaded again. The playlist uses the existing copy.

After choosing an image, the menu offers Change cover and Remove cover. Removing the cover restores the default playlist icon.

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, adjust volume with the speaker slider on the right of the player. After closing the main window, controls remain available in the tray mini-player. Open Thyron restores the window; Quit exits the app.
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.

The outline marks keyboard focus; the colored title and status icon mark the current track. Moving focus does not change playback. Hovering with the mouse only changes the background, without an outline.

Track and playlist sync

Transfers are started manually between devices on the same local network. Sync the whole storage or send selected tracks or playlists. A playlist is sent together with its tracks and cover. Files already on the receiving device are reused, so tracks are not duplicated.

  1. Connect both devices to the same local network and choose storage on each. On the receiving device, open Settings → Receive. Wait for Ready to receive and leave the window open.
  2. For the whole collection, open Settings → Synchronize on the sending device. For individual tracks or playlists, hold an item in Library, select any others, and click Share in the selection toolbar. Send music opens and starts looking for receiving devices automatically.
  3. Click a discovered device to start transferring. The refresh button repeats discovery. During transfer, the dialog shows the file count, progress, and current file name. Keep both apps open until Synchronization completed appears.
Enable receiving on the second device first. Hold a track to select it and click Share. You can send one or more playlists in the same way, together with their covers and tracks. Files already on the receiving device are not copied again.

Application settings

Open Settings with the sliders icon to the left of the Library heading. The panel contains language, interface scale, volume normalization, sending and receiving music, About, and a link to storage.

  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. Normalize track volume is on by default. Turn it off to keep the original differences in playback volume. Audio files are not rewritten.
The sliders icon beside Library opens Settings. Here you can turn off volume normalization or switch storage.

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: