# Thyron

> 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.

- [Home](https://thyron.org/)
- [Documentation](https://thyron.org/documentation.html): Instructions for installing Thyron, adding audio files, managing playlists, and transferring a library between devices.
- [Installation](https://thyron.org/documentation.html#installation): Select an operating system. Each tab lists the installer format, installation steps, and how to add audio files.
- [Adding audio files](https://thyron.org/documentation.html#library): 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.
- [Searching tracks and playlists](https://thyron.org/documentation.html#search): Search works within the current storage and checks track names, artists, and playlist titles. Results update as the query is entered.
- [Creating and editing playlists](https://thyron.org/documentation.html#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.
- [Playback controls](https://thyron.org/documentation.html#playback): 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.
- [Keyboard controls (VIM mode)](https://thyron.org/documentation.html#vim): VIM mode moves focus between tracks and playlists using the keyboard. Moving focus alone does not change the playing track.
- [Local network synchronization](https://thyron.org/documentation.html#sync): 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.
- [Language and interface scale](https://thyron.org/documentation.html#settings): The menu icon beside search opens Settings. The panel contains language and scale settings, local network sync, and About.
- [Supported audio formats](https://thyron.org/documentation.html#supported-formats): The library scans MP3, M4A, AAC, ALAC, FLAC, OGG, WAV, and AIFF files. OGG is supported on Windows, Linux, and Android. The Apple playback path excludes OGG. Actual playback also depends on the codec inside the file.
- [Support](https://thyron.org/documentation.html#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.
- [Privacy Policy](https://thyron.org/privacy.html)
- [Terms of Service](https://thyron.org/terms.html)
- [Cookie notice](https://thyron.org/consent.html)

## Installation

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

### Windows

- [Download Windows](https://github.com/E-Bor/thyron-feedback/releases/latest/download/thyron.exe)
- [Documentation](https://thyron.org/documentation.html#windows)

1. Download the installer: Download the .exe file using the link below.
2. Install the application: Open the downloaded file and follow the installer instructions.
3. Add a folder: Launch Thyron. In Storage, select Add storage folder and choose a folder containing audio files.

The app reads files from the selected folder. If the folder is moved or renamed, select it again in Storage.

### macOS

- [Download macOS](https://github.com/E-Bor/thyron-feedback/releases/latest/download/thyron.dmg)
- [Documentation](https://thyron.org/documentation.html#macos)

1. Download the disk image: Download the .dmg file and open it in Finder.
2. Install in Applications: Drag Thyron into Applications, then launch it from that folder.
3. Add a folder: In Storage, select Add storage folder and choose a local folder containing audio files. Allow file access if prompted.

After installation, launch Thyron from Applications. The .dmg disk image can be ejected.

### Linux

- [Download Linux](https://github.com/E-Bor/thyron-feedback/releases/latest/download/thyron.deb)
- [Documentation](https://thyron.org/documentation.html#linux)

1. Download the package: Download thyron.deb. This installer is intended for distributions that support Debian packages.
2. Install the package: Open a terminal in the folder containing the downloaded file and run the command below.
3. Launch the application: Open Thyron from the application menu. Add a folder containing audio files in Storage.

The command expects a file named thyron.deb in the current terminal directory. Adjust the filename in the command if it differs.

### Android

- [Download Android](https://github.com/E-Bor/thyron-feedback/releases/latest/download/thyron.apk)
- [Documentation](https://thyron.org/documentation.html#android)

1. Download the APK: Download the .apk file to the device and open it.
2. 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. Add a folder: Open Storage → Add storage folder. Grant file access and select a folder in the device’s internal storage.

Select a folder in internal storage rather than the virtual Documents provider. Permission to install apps from this source can be revoked after installation.

### iOS

- [Download iOS](https://apps.apple.com/app/thyron/id6796647188)
- [Documentation](https://thyron.org/documentation.html#ios)

1. Open the App Store page: Open the App Store link below on an iPhone or iPad.
2. Install the application: Tap Get or the download icon, wait for installation to finish, then open Thyron.
3. Import audio files: In Storage, tap Import audio files. Select files in the system picker. Thyron copies them into app storage.

Download files from iCloud or another source to the device before importing them.

## 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.

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.
On iOS, open Storage → Import audio files and select files in the system picker. They are copied into the app’s internal storage.
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.

On desktop and Android, the original folder must remain accessible. If it is moved or disconnected, select it again. Recovering a collection after device loss requires a separate backup of the files.

## Searching tracks and playlists

Search works within the current storage and checks track names, artists, and playlist titles. Results update as the query is entered.

Enter part of a title or artist name in the search field above the library.
To narrow the results, use several words, such as part of a title and an artist name. Search ignores letter case and diacritics.
Fuzzy search allows small spelling errors. If there are no results, shorten the query or check the title and artist in the file’s metadata.

In the example, “sneky” matches “Sneaky Snitch” by Kevin MacLeod. The example audio files are not included with the application.

## 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.

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.
Select an existing playlist. To create one, choose Add playlist, enter a name, and confirm with OK.
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.

Removing a track from a playlist keeps the original file. Deleting it from the library deletes the file and removes the track from all playlists. Check the selected action before confirming.

## 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.

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.
Move the progress slider to seek within the track. Shuffle changes the track order; repeat enables repeated playback.
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.

Playback works without an internet connection while the audio file remains accessible to the app on the device.

## 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.

Connect both devices to the same local network. Open Thyron and select a storage on each device.
On the receiving device, open Settings → Local network sync → Receive. Wait for Ready to receive and keep the window open.
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.

Existing tracks on the receiving device are not deleted. If the device is not found, check local network permission, firewall settings, and device isolation on guest Wi-Fi.

## Language and interface scale

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

In Language, select English, Russian, Spanish, Chinese, or Hindi. The application language is configured separately from the website language.
Use Interface scale to select the size of text and controls.
Open About to view application information, the privacy policy, and support contact options.

Settings and library data are stored on the device. Website analytics operates separately from the app and starts only after cookie consent.

## 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.
Typing sends text to the search field. While that field is focused, Space inserts a space instead of toggling playback.

## Supported audio formats

The library scans MP3, M4A, AAC, ALAC, FLAC, OGG, WAV, and AIFF files.
OGG is supported on Windows, Linux, and Android. The Apple playback path excludes OGG. Actual playback also depends on the codec inside the file.

## Common questions

### Can I import playlists from Spotify or other streaming services?

Direct import from streaming services is not available yet. Thyron needs individual audio files, and playlists are created in the app. A list of song titles cannot replace the music files.

### Can I delete the original files after adding them to Thyron?

On desktop and Android, Thyron reads music from your selected folder, so the original files must remain accessible. If you move the folder, select it again. On iOS, imported files are copied into app storage. Before deleting the originals, check that the import has finished and the tracks play correctly.

### Why can’t my devices find each other?

Keep Receive open on the second device and make sure both devices are on the same local network. On iPhone, allow Thyron access to the local network. Guest Wi-Fi, router device isolation, or a VPN can prevent discovery. Try your regular home network and search again.

### Can I recover my music if I lose my device?

Thyron does not provide cloud recovery. Keep a separate backup of your music files for that situation. Local network transfer helps move music between available devices, but it does not replace a backup.

## Support

- [Thyron Feedback](https://github.com/E-Bor/thyron-feedback)
- [qwert.zxcqe.iop@mail.ru](mailto:qwert.zxcqe.iop@mail.ru)