Skip to content

About

Local music library manager and player for Windows. Create playlists, drag tracks into order, and listen as you organize. Keep your chosen order in File Explorer with optional numbered filenames, or save it in playlist files. Undo and redo library changes while TrackIndex is open.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

1 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

TrackIndex

Code: GitHub Website Mirror: SourceForge

TrackIndex Logo

Download (Windows)

Your Local Music Library Manager & Player

Arrange music by dragging tracks, and keep the order in filenames, playlists, or both.

Version License Last Commit Open Issues Stars Downloads (7d)

Overview

Open a music folder or create a playlist, then drag your tracks into the order you want. Listen as you organize, and undo or redo library changes while TrackIndex is open.

Want that order to appear in File Explorer too? TrackIndex can add numbers to your filenames so the tracks appear in your chosen sequence when sorted by Name. You can also save the order in a playlist file for music players that support it, without renaming your tracks.

Features

  • Music folders and playlists: Several local libraries within reach, with playlist creation and support for common audio formats.
  • Drag-and-drop ordering: Individual tracks or whole selections moved together.
  • Order beyond the app: Optional numbered filenames and M3U/M3U8 playlist files.
  • Built-in music player: Artwork, track details, seeking, shuffle, repeat and a compact view.
  • Undo and redo: Reordering, added or removed tracks, and playlist changes while TrackIndex is open.
  • Background loading: Artwork and track details load as you browse, prioritizing the tracks in view.
  • Standalone option: Run without installation, alongside the regular Windows installer.

Basic usage

  1. Get the Windows installer or standalone app. Choose the installer for a normal setup, or standalone to run without installing.
  2. Select Open Folder for existing music, or Create Playlist for a new folder under the Music folder selected in Settings.
  3. Choose Filename Prefixes for numbered filenames, Playlist File to save the order without renaming tracks, or both.
  4. Drop audio files into the track list to copy them into the library. The original files stay unchanged. Drag one track or a selection into position.
  5. Double-click a track or use its artwork control to listen.
  6. Use Ctrl+Z to undo and Ctrl+Shift+Z to redo library changes while TrackIndex is open. See Undo, removal and recovery for what happens to removed files.

Using TrackIndex

Music folders and new playlists

Each library uses the audio files directly inside one folder. Subfolders can appear as separate libraries beneath your Music folder; their tracks are not combined into the parent library.

Create Playlist creates a new folder and an empty M3U8 playlist under the Music folder selected in Settings. Add music by dropping audio files into the track list; imports copy the files and leave the originals intact.

Filename and playlist order

Choose Filename Prefixes to store order in numbered filenames, Playlist File to save it without renumbering audio, or both. For numbered files, sort by Name in File Explorer to see the saved sequence. M3U and M3U8 playlists retain playback order in compatible players.

If an existing playlist and filenames disagree, setup asks which order to use. TrackIndex keeps the selected filenames and playlist references aligned without editing embedded tags or changing audio content.

Playback and saved order

Compact the player to leave more room for the library. Compatible keyboard and Windows media controls also work in the background.

Shuffle affects playback only, leaving the saved library order unchanged. After successfully saved library changes, the queue updates while keeping the current song where possible.

Undo, removal and recovery

While TrackIndex is open, you can undo and redo track reordering, filename changes, added or removed tracks, and playlist updates.

Removed audio stays in local recovery storage while TrackIndex is open, so you can undo the removal. On normal close, it goes to the Windows Recycle Bin. If cleanup cannot finish, recovery data is retained for later handling. Interrupted changes are checked on the next start, with recovery options when needed.

Supported audio formats

MP3, WAV, FLAC, OGG, OPUS, M4A, AAC, WMA, AIFF and AIF.

Installer and standalone

The standalone executable runs without installation. Both versions store settings in %LOCALAPPDATA%\TrackIndex; settings do not travel alongside the executable. Library recovery data stays inside the affected music folder.

Project resources

For Developers

Requirements

Running From Source

py -3.14 -m pip install -r TrackIndex/requirements.txt
py -3.14 TrackIndex/TrackIndex.py

Playback requires the local TrackIndex/native/libmpv/mpv-2.dll runtime. The existing local runtime and its notices are retained; restore the DLL manually when setting up a fresh checkout. The Python binding is installed through requirements.txt; local packaging also retains the existing TrackIndex/vendor/mpv.py binding.

Release Packaging

Local packaging follows the same layout and publishing workflow as the other Justagwas applications:

  • TrackIndex/ronefile.spec builds the standalone executable.
  • TrackIndex/ronedir.spec builds the installer payload.
  • TrackIndex/dist/ONEDIR.iss produces the installer using the existing TrackIndex assets and information files.
  • publish-trackindex.cmd prompts for release metadata, builds and signs both executables and the installer, and writes matching latest.json files to release/ and the Astro project directory.

The publisher uses the existing Python installation, with TrackIndex's requirements and PyInstaller already installed. It does not create an environment or run a test suite. Select Python 3.14 as the default Python launcher installation. Production packaging requires Inno Setup and the configured signing certificate.

Publishing scripts, specifications, version resources, installer assets, and release outputs are local ignored files, matching the sibling repositories. A fresh checkout needs these local packaging files restored before publishing. Both packaged distributions include the playback runtime; end users do not need Python or a separate libmpv installation.

Security and OS Warnings

Contributing

Contributions are welcome.

Contact

License

Licensed under the GNU General Public License v3.0 (GPL-3.0).

See LICENSE.

About

Local music library manager and player for Windows. Create playlists, drag tracks into order, and listen as you organize. Keep your chosen order in File Explorer with optional numbered filenames, or save it in playlist files. Undo and redo library changes while TrackIndex is open.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages