From 43335222568c66bf2be159a54ac20548c5b4713e Mon Sep 17 00:00:00 2001
From: austinried <4966622+austinried@users.noreply.github.com>
Date: Sat, 3 Oct 2026 23:45:47 +0000
Subject: [PATCH] docs: rebuild the README for the native rewrite

---
 README.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 00000000..214224f5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,70 @@
+<h1><img src=".assets/logo.png" alt="subtracks logo" width="44" align="texttop" /> subtracks</h1>
+
+[![release](https://img.shields.io/github/v/release/austinried/subtracks?label=release&logo=github)](https://github.com/austinried/subtracks/releases/latest/)
+[![downloads](https://img.shields.io/github/downloads/austinried/subtracks/total?label=downloads&logo=github)](https://github.com/austinried/subtracks/releases/)
+[![license](https://img.shields.io/github/license/austinried/subtracks?color=b4eb12&label=license)](LICENSE)
+
+subtracks is an open source Android client for [Subsonic-compatible](http://www.subsonic.org/pages/api.jsp) servers ([Navidrome](https://www.navidrome.org/), [gonic](https://github.com/sentriz/gonic), [LMS](https://github.com/epoupon/lms), [Nextcloud Music](https://apps.nextcloud.com/apps/music) and more). It is written natively in Kotlin and Jetpack Compose and gives you clean, convenient access to your music in the style of a modern media player.
+
+## Screenshots
+
+<a href="metadata/en-US/images/phoneScreenshots/01_home.png"><img src="metadata/en-US/images/phoneScreenshots/01_home.png" alt="home" width="150"/></a>
+<a href="metadata/en-US/images/phoneScreenshots/02_now-playing.png"><img src="metadata/en-US/images/phoneScreenshots/02_now-playing.png" alt="now playing" width="150"/></a>
+<a href="metadata/en-US/images/phoneScreenshots/03_library-albums.png"><img src="metadata/en-US/images/phoneScreenshots/03_library-albums.png" alt="albums" width="150"/></a>
+<a href="metadata/en-US/images/phoneScreenshots/04_album.png"><img src="metadata/en-US/images/phoneScreenshots/04_album.png" alt="album" width="150"/></a>
+<a href="metadata/en-US/images/phoneScreenshots/05_artist.png"><img src="metadata/en-US/images/phoneScreenshots/05_artist.png" alt="artist" width="150"/></a>
+<a href="metadata/en-US/images/phoneScreenshots/06_library-artists.png"><img src="metadata/en-US/images/phoneScreenshots/06_library-artists.png" alt="artists" width="150"/></a>
+<a href="metadata/en-US/images/phoneScreenshots/07_search.png"><img src="metadata/en-US/images/phoneScreenshots/07_search.png" alt="search" width="150"/></a>
+
+## Download
+
+<div align="center">
+  <a href="https://play.google.com/store/apps/details?id=com.subtracks"><img src=".assets/google-play-badge.png" width="250"/></a>
+  <a href="https://f-droid.org/en/packages/com.subtracks/"><img src=".assets/f-droid-badge.png" width="250"></a>
+  <a href="https://github.com/austinried/subtracks/releases/"><img src=".assets/github-badge.png" width="250"/></a>
+</div>
+
+## Features
+
+- Home screen to browse your library over many categories, genres, and more
+- Album and artist artwork, shown full-resolution in the detail and now playing views
+- Downloads with album, artist and playlist bulk downloads, download quality and a metered-connection toggle
+- Search across albums, artists, playlists and songs, with per-list sort and filter controls
+- Gapless playback, an editable queue you can reorder and jump through, and loop and shuffle modes
+- Up next queue to add items into the currently playing queue without rewriting it
+- Multiple server support with quick switching
+- Stream quality (bitrate and format) settings for Wi-Fi and mobile and automatic switching
+- Scrobbling and starred items, cached while offline and sent back to the server when online
+- Media notification and headset/Bluetooth controls
+- Adaptive theming from the current song's artwork
+
+The full library is mirrored at sync, so browsing, searching, sorting and filtering all work without waiting on the server. Only media and artwork are fetched on demand, and not even that when they're already downloaded.
+
+## Building
+
+The project's entire toolchain is provided by a Nix flake. The default devshell provides JDK, Gradle and the Android SDK, so there is nothing to install by hand.
+
+Therefore, to get started, you'll need to install Nix. I prefer [Lix](https://lix.systems/install/).
+
+```sh
+nix develop
+gradle :app:assembleDebug
+```
+
+Test, lint and screenshot commands, plus the integration harness, are documented in [AGENTS.md](AGENTS.md). The architecture is described in [docs/architecture.md](docs/architecture.md).
+
+## Translations
+
+Want to see subtracks in your language? Visit the project on [Weblate](https://hosted.weblate.org/engage/subtracks/) to help!
+
+<a href="https://hosted.weblate.org/engage/subtracks/">
+<img src="https://hosted.weblate.org/widgets/subtracks/-/subtracks/multi-auto.svg" alt="Translation status" />
+</a>
+
+## AI usage disclosure
+
+This project contains code and documentation generated by LLM, which is created via human prompting, iteration and review.
+
+## License
+
+subtracks is free software, licensed under the [GNU General Public License v3.0](LICENSE). It has no ads and no telemetry, and uses only free/libre dependencies.