https://github.com/pythoninthegrasses/mt
🎵 🌳
https://github.com/pythoninthegrasses/mt
alpinejs basecoat-ui rust tauri
Last synced: about 1 month ago
JSON representation
🎵 🌳
- Host: GitHub
- URL: https://github.com/pythoninthegrasses/mt
- Owner: pythoninthegrasses
- License: unlicense
- Created: 2025-02-12T04:02:15.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-03T17:28:15.000Z (about 1 month ago)
- Last Synced: 2026-04-03T20:08:43.223Z (about 1 month ago)
- Topics: alpinejs, basecoat-ui, rust, tauri
- Language: JavaScript
- Homepage:
- Size: 10.7 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# mt
`mt` is a simple desktop music player designed for large music collections.
## Minimum Requirements
* OS
* macOS Sequoia (15.7+)
* Linux
* Debian
* Ubuntu
* Windows 11 (21H2+)
## Features
* **Built for large libraries**: virtual scrolling, content-aware reloading, and LRU-cached artwork
* **Cross-platform**: macOS, Linux, and Windows with native media key and OS Now Playing support
* **Themeable**: light, dark, and system themes with customizable columns
* **Artists and Albums views**: split-pane artist browser and album grid with detail view
* **Playlists and queue management**: drag-and-drop reordering, play next, play history navigation
* **Metadata editing**: read and write tags directly on audio files, including batch editing
* **Watched folders**: multi-directory monitoring with real-time filesystem events, duplicate detection, and move tracking
* **Keyboard-driven**: shortcuts for playback, search, navigation, and type-to-jump by artist
* **Last.fm integration**: scrobbling, now playing, loved track sync, queued retry on failure, and bidirectional loved tracks sync
## Downloads
| Platform | Architecture | Download |
|----------|--------------|----------|
| Windows | x64 | [mt_1.0.0_x64-setup.exe](https://github.com/pythoninthegrass/mt/releases/download/v1.0.0/mt_1.0.0_x64-setup.exe) |
## Development
See [Builds](docs/builds.md) for build configuration, performance tuning, and signing.
### Requirements
* [node 24.2.0](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
* [rust 1.92.0](https://doc.rust-lang.org/book/ch01-01-installation.html)
* Be sure to install `rustup`!
* [task](https://taskfile.dev/docs/installation)
### Setup
```bash
# install deps
task npm:install
# run dev server
task tauri:dev
```
## Credit
* MusicBee for years of rock-solid playback and inspiration to build a subset of its features for other operating systems
* Logo
* [Music - Sentya Irma](https://thenounproject.com/icon/music-6387002/)
* [mango tree - Aisyah](https://thenounproject.com/icon/mango-tree-6730625/)
* [Glasses - Iconic](https://thenounproject.com/icon/glasses-155583/)
## TODO
See [TODO.md](TODO.md) for a list of features and improvements.