{"id":43980426,"url":"https://github.com/ckaznable/oto","last_synced_at":"2026-02-22T05:02:16.997Z","repository":{"id":317813218,"uuid":"1054714780","full_name":"ckaznable/oto","owner":"ckaznable","description":"A picky, unstable, yet simple music player.","archived":false,"fork":false,"pushed_at":"2026-02-21T08:26:07.000Z","size":966,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-21T15:48:25.004Z","etag":null,"topics":["music-player","ratatui","rust","tui"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ckaznable.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-11T08:26:08.000Z","updated_at":"2026-02-21T08:26:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"effd1c7a-e24b-483c-bf23-1402a1aa6b08","html_url":"https://github.com/ckaznable/oto","commit_stats":null,"previous_names":["ckaznable/oto"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/ckaznable/oto","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ckaznable%2Foto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ckaznable%2Foto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ckaznable%2Foto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ckaznable%2Foto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ckaznable","download_url":"https://codeload.github.com/ckaznable/oto/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ckaznable%2Foto/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29705523,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-22T03:17:42.375Z","status":"ssl_error","status_checked_at":"2026-02-22T03:17:31.622Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["music-player","ratatui","rust","tui"],"created_at":"2026-02-07T09:00:34.705Z","updated_at":"2026-02-22T05:02:11.985Z","avatar_url":"https://github.com/ckaznable.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# おと(Oto)\n\nA picky, unstable, yet simple music player.\n\n![Rust](https://img.shields.io/badge/Rust-2024_Edition-orange)\n[![Built With Ratatui](https://img.shields.io/badge/Built_With_Ratatui-000?logo=ratatui\u0026logoColor=fff)](https://ratatui.rs/)\n![License](https://img.shields.io/badge/License-MIT-blue)\n\n![](./assets/demo.png)\n\nOTO is designed for audiophiles who prefer direct hardware access (ALSA) for bit-perfect playback. This means:\n\n1. **Exclusive Access**: It requires exclusive control of the audio device. Other applications may not be able to play sound while OTO is running.\n2. **Minimalist**: It focuses on high-quality playback and does not include \"fancy\" features like visualizers, streaming integration, or complex library management.\n\nIf you need a more general-purpose MPD client or a feature-rich player, consider using [rmpc](https://github.com/mierak/rmpc).\n\n\u003e **Note**: Due to personal interest in minimizing allocations during TUI rendering, the rendering code prioritizes performance over readability.\n\n## Features\n\n- **High-Resolution Audio**: Native DSD (DSF) playback and Hi-Res PCM support\n- **Multiple Formats**: FLAC, MP3, WAV, OGG, AAC, DSD/DSF\n- **ALSA Backend**: Direct hardware access for optimal audio quality\n- **TUI Interface**: Simple terminal UI built with ratatui\n- **MPRIS Support**: D-Bus integration for media controls\n- **Fuzzy Search**: Quick track search with Japanese romaji support\n- **Album Art**: Display cover art in supported terminals\n\n## Installation\n\n```bash\n# Standard installation\ncargo install --git https://github.com/ckaznable/oto\n\n# Install without Japanese dictionary support (no romaji search)\ncargo install --git https://github.com/ckaznable/oto --no-default-features\n```\n\n### Dependencies\n\n- Rust 1.92.0+ (nightly recommended for `let_chains` feature)\n- ALSA development libraries (`libasound2-dev` on Debian/Ubuntu)\n- D-Bus development libraries (`libdbus-1-dev` on Debian/Ubuntu)\n- Chafa (`libchafa-dev` or `chafa` package) for image rendering\n\n```bash\n# Debian/Ubuntu\nsudo apt install libasound2-dev libdbus-1-dev libchafa-dev\n\n# Arch Linux\nsudo pacman -S alsa-lib dbus chafa\n\n# Fedora\nsudo dnf install alsa-lib-devel dbus-devel chafa-devel\n```\n\n## Usage\n\n### TUI Mode (Interactive)\n\n```bash\n# Play music from a directory\noto tui --path /path/to/music\n\n# Use default device\noto tui --path ~/Music\n\n# Specify audio device\noto tui --path ~/Music --device hw:1,0\n```\n\n### Headless Mode\n\n```bash\n# Play without UI\noto play --path /path/to/music\n```\n\n### Initialize Japanese Dictionary (Optional)\n\n```bash\n# Download and build dictionary for Japanese track search\noto init\n```\n\n## Audio Device Selection\n\nOTO automatically detects USB DACs and prioritizes them. To list available devices:\n\n```bash\naplay -l\n```\n\nUse the `--device` flag to specify a device:\n\n```bash\noto tui --path ~/Music --device hw:2,0\n```\n\n## Feature Flags\n\n| Feature | Description |\n|---------|-------------|\n| `dict-jp` | Japanese dictionary for romaji search (default) |\n| `dict-jp-embed` | Embed dictionary into binary. No download needed, but increases binary size by ~15MB. |\n\n```bash\n# Build without Japanese support\ncargo build --release --no-default-features\n\n# Build with embedded dictionary\ncargo build --release --features dict-jp-embed\n```\n\n## Inspired By\n\n- [Amberol](https://gitlab.gnome.org/World/amberol) - A small and simple music player for GNOME\n- [rmpc](https://github.com/mierak/rmpc) - A beautiful MPD client for the terminal\n- [inori](https://github.com/eshrh/inori) - A beautiful MPD client for the terminal and support fuzzy search\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Acknowledgments\n\n- [ratatui](https://github.com/ratatui-org/ratatui) - Terminal UI framework\n- [symphonia](https://github.com/pdeljanov/Symphonia) - Audio decoding\n- [souvlaki](https://github.com/Sinono3/souvlaki) - MPRIS support\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fckaznable%2Foto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fckaznable%2Foto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fckaznable%2Foto/lists"}