Yoin Docs 中文 Join the test
Yoin 0.5, closed test

Docs

Joining the test, connecting your music, and finding your way around.

Getting startedJoin the closed test

  1. Join the tester group with the Google account that’s signed in on your phone.
  2. Open the test page on Google Play and tap Become a tester.
  3. Install Yoin from Google Play. It can take a few minutes to appear after you accept.
Play says Yoin isn’t available?Check that the account in the Play Store is the one you joined the group with. Switch accounts from your profile picture in the Play Store.

What you need

First launch

The first time you open Yoin, a short guide sets it up.

  1. Tap Get started and pick the services you listen with. You can pick more than one. With no account added yet, you need to pick at least one.
  2. Yoin shows what it does and what each service needs from you. Tap Next.
  3. Connect each service you picked. To do it later, tap Skip and add accounts in Settings › Accounts.
  4. Choose what goes on Home: drag sections into order and hide the ones you don’t want. Later, long-press Home to change how many rows a section shows.
  5. Choose how content slips under the top bar when you scroll: tide line, dots or cookie wave. Tap one to preview it.
  6. Tap Open Yoin. The button at the bottom turns into Home’s bar.

To go through it again, open Settings › About › Welcome guide. Your accounts and data stay as they are, and you can skip the service step.

AccountsSubsonic and Navidrome

Yoin works with Navidrome, Gonic, Airsonic and other servers that speak the Subsonic or OpenSubsonic API. You need the server’s address, and your username and password on it.

  1. In Settings › Accounts, tap Add account and pick Subsonic. The welcome guide has the same form.
  2. Enter the server address with http:// or https:// and the port if it has one, such as https://music.example.com. Then your username and password.
  3. Tap Connect. Yoin checks the server and your sign-in, saves the account and switches to it. If the check fails, what you typed stays in the form.
Use https if you canPlain http:// addresses work, which helps on a home network, but your password then crosses the network unencrypted.

Good to know

Spotify

You need Spotify Premium, and the Spotify app signed in to the same account on the same device. Yoin reads your library, searches, saves Liked Songs and edits playlists through Spotify’s Web API, and plays music through the Spotify app.

Spotify asks every app to identify itself with a Client ID, so you create one for yourself. It’s free and takes about five minutes. Yoin floats a small guide over your browser, with a copy button for each value, so you don’t have to switch back and forth.

  1. On the Spotify page in Yoin, tap Open Spotify for Developers. Your browser opens and Yoin shrinks to the guide above it. You can also open Spotify for Developers yourself.
  2. Log in with your Spotify account and tap Create app. Name and description can be anything, like Yoin.
  3. Under Redirect URIs, add both addresses, one at a time, and tap Add after each:
    yoin://auth/spotify/callback
    yoin://auth/spotify/app-remote
  4. Tick Web API and Android.
  5. Under Android packages, add the package name and the SHA1 fingerprint the guide shows, then tap Add. Use the values the guide shows on this phone.
    com.gpo.yoin
  6. Agree to the terms and tap Save.
  7. Copy the Client ID from your app’s page and tap Back to Yoin. Yoin fills it in from the clipboard. Then sign in to Spotify and allow Yoin.
Made an app for Spotoolfy?You can use the same one: add Yoin’s two redirect URIs and the Android package to it. How, for Spotoolfy users.
Installed Yoin from an APK before?The SHA1 fingerprint belongs to the copy of Yoin on your phone, and the Google Play version has its own. Add the one Yoin shows now, next to the old one.

Good to know

Apple Music

You need an Apple Music subscription for your country or region. Songs play inside Yoin, through Apple’s MusicKit.

  1. In Settings › Accounts, tap Add account and pick Apple Music.
  2. Choose a developer token. Yoin’s token service is shared by everyone on Yoin and needs nothing from you. Your own token service needs an Apple Developer Program membership, US$99 a year, and the address of your service.
  3. Tap Connect, sign in with your Apple ID and allow Yoin to access your media library. If it doesn’t go through, tap Connect again. It can take two or more tries.

Good to know

Switching accounts

You can keep several accounts, such as a Navidrome server at home, a Spotify account and an Apple Music account, and more than one of each. Each account has its own library, Home, ratings, notes, reviews and Memories. Yoin doesn’t mix them.

  1. Tap your picture at the top right of Home, or open Settings › Accounts.
  2. Tap the account you want. Home and Library load its music. If the switch fails, Yoin goes back to the account you were on, where you left it.
Save your note firstSwitching accounts clears a note in Now Playing that you haven’t saved.

BrowseHome

Home is built from your account’s music and what you do in Yoin. It has six sections, and you choose which ones show.

SectionWhat it shows
ActivitiesAlbums, artists and playlists you played or opened lately. On Spotify it also uses Spotify’s recently played. With little history, the row gets shorter instead of filling up with blanks.
Jump Back InAlbums, songs and playlists you play often, mixed with cards that show a note or score you left. Tap a song to play it, or an album or playlist to open it.
Recently AddedWhat joined your library in about the last 30 days: albums on top, songs in two rows below.
RediscoverAlbums and songs you rated, reviewed or wrote notes on, and haven’t played in Yoin for at least 90 days. Rated ones come first, highest score first. On a tie, the one you’ve gone longest without comes first.
Recently PlayedAlbums your service says you played lately, including on other devices.
Your PlaylistsThe playlists in this account: your own, ones you follow, and ones the service made for you.

Small marks on album covers show what you left there: filled for an album score, outlined for a track average, dashed for notes.

After you rate or write about an album that can become a Memory, or when you stay on Home for a while, a Memories bubble may show at the top. Tap it to open that album’s Memory. Pull down on Home to open all of Memories.

Editing Home

Each account has its own Home layout. With Cloud sync on, it follows you to your other devices. To start editing, do any of these:

Then:

Library

Tap Library in the bar. All shows your playlists, artists and albums together. Artists are round, albums and playlists square. Tap a chip at the top to see only Playlists, Artists, Albums, Songs or Favorites. Tap it again, or tap ✕ at the left, to go back to All.

Each service keeps its library its own way, and Yoin shows it as the service has it.

ViewSubsonicSpotifyApple Music
FavoritesEverything you starred on your serverNot shown. Songs is your Liked Songs, and albums and artists are the ones you saved and follow.Not shown. Apple Music doesn’t offer it.
SongsThe tracks of your newest albums, in album order, loaded page by page. If a page fails, retry or skip it at the bottom.Your Liked Songs, newest first, up to 200Up to 500 songs from your library, by title
Albums and playlistsAll of them, page by pageUp to 200 of eachAll of them, page by page

Sorting and scrolling

In All, Artists, Albums and Playlists, tap Sort to change the order. Songs and Favorites keep a fixed order. Each account and view remembers its own choice on this device.

When Playlists has both your own playlists and ones you follow, a By You chip shows at the top. Tap it to see only yours. On Apple Music, Yoin goes by which playlists Apple Music marks as editable.

In All, Artists and Albums, a handle shows at the right while you scroll. Drag it to jump through letters (A–Z, kana, Hangul, #), or through dates when sorted by Recents. It hides again shortly after you stop, out of the way of the covers.

Tap the search bar at the top of Library to search your library. To go straight to the Spotify or Apple Music catalog, long-press Library in the bar. On Subsonic, both search your server.

Albums, artists and playlists

An album opens with its cover, its details, play and shuffle buttons, when you last played it in Yoin, and its record-groove emblem at the top right.

An artist page has a round picture, the songs you’ve played most, and the discography. Star an artist on Subsonic, or follow one on Spotify.

A playlist page lets you play or shuffle it. If you can edit the playlist, on Subsonic or Spotify, you can rename it, change its description, remove songs or delete it there. Apple Music playlists are read-only.

Tap ⋯ on a page or a track for Play next (Subsonic and Apple Music), Add to queue, Add to playlist, Go to artist, opening it in the service’s app, or Share. On a large screen, actions already in the bar are left out of the menu.

On a tablet or an unfolded foldable, albums, artists and playlists open in a column next to Home or Library, with one bar across both.

PlayNow Playing

Tap the song in the bar to open Now Playing. Swipe down, use the back gesture or tap the arrow at the top to close it.

ControlWhat it does
Rating barDrag to rate the song from 0.0 to 10.0. See Ratings and reviews.
HeartStars the song on Subsonic, or adds it to Liked Songs on Spotify. On Apple Music it’s +, to add the song to your library.
PreviousMore than about 3 seconds into a song, goes back to its start. Earlier than that, goes to the previous song.
Play modeA round button. Each tap steps through repeat all, shuffle, shuffle with repeat one, and repeat one. Long-press it and it splits in two, shuffle on the left and repeat on the right, so you can switch either one; it joins back after a few seconds. Shuffle play on an album or playlist is different: it shuffles the tracks and starts from the first.
QueueWhat plays next. See Queue.
Lyrics, About, NoteSynced lyrics, song info, and your notes for this song.
CoverTap it to see it larger, with the current lyric line below, when the screen has room. Tap again to go back. Long-press it for the song’s options: Play next, Add to queue, Go to album or artist, Share, Open in Spotify or Apple Music, and Keep screen on.
DevicesWhere the music plays. See Cache, Cast and sound.

While a song loads, or while Yoin connects to the Spotify app, the play button shows that it’s loading, and switches to playing once the sound starts.

On a phone, tapping the bar opens Now Playing full screen. On a tablet or foldable, it first opens as a panel at the right. The button at the panel’s top corner makes it full screen. Going back steps from full screen to the panel, then to the bar. On a phone held sideways, the bar moves to the side.

On Apple Music, when you play a list of more than 300 songs, Yoin leaves out songs that can’t play and queues up to 100 around the one you picked, about 20 of them before it.

Queue

Tap Queue in Now Playing. It lists what will play, in the order it will play, even with shuffle on. Songs that have finished drop off. It has three parts:

Play next puts a song right after the current one, on Subsonic and Apple Music. Add to queue puts it at the end of Next in queue, before the rest of the album or playlist.

Hearts and playlists

What the heart does depends on the service. It’s separate from your rating: a high score doesn’t light the heart, and the heart doesn’t add a score.

Apple Music has no heart in Yoin. Tap + instead to add a song to your library, in catalog search, on an album’s tracks or in Now Playing. Apple Music adds songs in the background, so the button waits until Yoin finds the song in your library before it shows ✓. Your library then refreshes without moving you from where you are. Songs can’t be removed from your Apple Music library in Yoin.

On Subsonic and Spotify, you can manage playlists you’re allowed to edit. Apple Music playlists are read-only.

Lyrics and notesLyrics

Tap Lyrics in Now Playing. Yoin chooses lyrics in this order:

  1. Lyrics you picked or edited yourself always come first.
  2. On Subsonic, your server’s lyrics. Yoin doesn’t look anywhere else unless you search.
  3. On Spotify and Apple Music, which don’t offer lyrics, Yoin checks what it has saved on your phone, then QQ Music, NetEase Cloud Music and LRCLIB, in that order.
  4. Huawei Music is only used when you search yourself.

If the lyrics are wrong, such as a live version, search from the lyrics tools. Results come from QQ Music, NetEase Cloud Music, Huawei Music and LRCLIB. Check the title, artist and length, then tap one to use it. To write your own or paste LRC text, open the lyrics editor.

Lyrics Yoin finds on its own are kept for 30 days. Lyrics you picked from search don’t expire, and lyrics you typed or pasted are never cleared to make room.

Translating and sharing

In Settings › AI features, set Answer in to the language you want. It’s separate from the app’s language. Then tap the translate button in the lyrics.

To copy or share lines:

  1. Tap ✓ to select lines. The lyrics stop following the song while you select.
  2. Tap up to 15 lines, from anywhere in the song.
  3. Copy them as text. They come out in song order, with a blank line between separate parts, the translation if it’s on, and the title and artist at the end.
  4. Or share them as an image. Choose Card, 1440 px wide and as tall as the lines need, or Story, 1080 × 1920 and scaled to fit, and one of four colour sets from the cover: Soft, Deep, Vivid or Mist. Save puts it in Pictures/Yoin on Android 10 and later. Share sends it.

Lyrics and notesRatings and reviews

Ratings and reviews are kept in Yoin, on every service. On Subsonic, song ratings also go to your server.

To rate and review an album, tap the record-groove emblem at the top right of the album, or the review in its Memory. Drag across the bar to score the album. The emblem changes as you drag, and the score saves when you let go. Scrolling the panel up and down doesn’t change it. Write your review in the box below. It grows as you write and saves when you close the panel.

The emblem shows where an album stands:

Notes

A note is pinned to a moment in a song and kept in Yoin.

  1. In Now Playing, tap Note.
  2. Tap the box and start typing. The moment you start, Yoin takes the current time for the note.
  3. If the song has moved on and you want the note at the new moment, tap the align button next to the box.
  4. Tap save. The note joins the list, and the keyboard stays open for the next one. An empty box folds back when you close the keyboard.
Drafts stay with their songIf the song changes before you save, your draft stays with the song you wrote it for, and its small cover shows next to the box. Switching accounts clears an unsaved draft, so save first.

Scrapbook

Swipe left on an album to turn to its second page. The Scrapbook collects everything you left on the album, laid out as paper on a dotted page:

On an album you haven’t left anything on, the page lists its tracks. Tap one to play it.

Memories

Memories collects the albums you’ve spent time with, one card per album, for the account you’re on. Pull down on Home to open it, or tap the bubble at the top of Home or the Memory widget.

An album becomes a Memory when it has at least 4 known tracks and you’ve done one of these:

Playing an album many times, asking Gemini about it, or giving it only an album score isn’t enough.

On a phone, Memories has two states. On a wide tablet, they sit side by side.

Pulling down on a card only stretches it; it doesn’t open the diary. To leave the diary, pull down at its top, drag its top bar, tap the small cover or go back. To leave Memories, push up on a card, tap Home at the top, or push up again once the diary has stopped at its end.

With a Gemini key, the title of each Memory is written by AI. Tap the title to write your own, or to bring back the one Yoin gave it.

OptionalAI features

Paste your own Gemini API key in Settings › AI features and tap Save key. Pick the language under Answer in. Requests go straight from your phone to Google’s Gemini API and are billed to your key. Without a key, everything else in Yoin works the same.

What Gemini receives depends on the feature:

FeatureSent to Gemini
Song info and Ask GeminiTitle, artist, album, language and your question. Not your notes or reviews.
Lyric translationTitle, artist, the lyrics and the language, including lyrics you typed yourself. Not your notes or reviews.
Memories lineListening facts, such as play counts, dates and how many tracks you rated. Not the text of your notes or reviews.
Memory titleAlbum details and the review or note shown on the card, which can be the whole text.

Once a key is saved, Memories lines and titles are made when Memories loads, without a separate tap. The key stays on your phone and doesn’t sync to Google Drive, though Android backup can include it. Answers and translations can be wrong.

NeoDB

In Settings › NeoDB, enter your instance, such as neodb.social, and sign in, or paste an access token instead.

After that, an album’s rating and review go to NeoDB when you save them, as long as the album matches an entry there. Closing the album’s rating panel or saving a review in Memories is enough. The rating panel and the bottom of the diary show whether it has synced.

Cloud sync

Off unless you turn it on, in Settings › Cloud sync. Once you allow Google Drive, Yoin keeps your records in a hidden Yoin folder in your own Google Drive, which counts toward your storage. Yoin can only see its own folder, not your other files, and there’s no Yoin account. Cloud sync needs Google Play services, and it might not be available in every test build.

Sync runs when you open or leave Yoin, after changes, and when you ask for it.

SyncsStays on this device
Notes, and the ones you deletedPasswords, sign-ins and API keys
Song and album ratings, album reviewsListening history and Activities
Home layoutThe audio cache
Memory titles and lines, including your own titlesLibrary sort order
Lyric translations, and About and Ask Gemini answersLyrics you typed or pasted yourself (their translations can sync)
Translation language, Spotify Client ID and scroll edge styleThe address of your own Apple token service
Account names, server addresses and usernames

The files aren’t end-to-end encrypted. That’s why passwords, sign-ins and keys never go there.

On a new phone with the same Google Drive, Subsonic accounts are matched by server address and username, and Spotify accounts by Spotify user ID. Apple Music gives no account ID that stays the same across devices, so link it yourself once: tap Link on the Apple Music records in Cloud sync.

SystemWidgets

Long-press an empty spot on your home screen, tap Widgets and find Yoin.

Resize a widget and its layout adjusts to the new size.

Appearance and accessibility

Cache, Cast and sound

ReferenceService support

What each service can do in Yoin. Ratings, notes, reviews, the Scrapbook, Memories, your Home layout, the AI features and NeoDB work on all three, kept by Yoin. Music files on your phone aren’t supported yet.

FeatureSubsonicSpotifyApple Music
Accounts and playback
You needA Subsonic-compatible serverSpotify Premium and the Spotify appAn Apple Music subscription
Music plays inYoin, streamed from your serverThe Spotify app, controlled by YoinYoin, through MusicKit
Lock screen and notification controlsYesThrough the Spotify appYes
Other devicesCast to a ChromecastSpotify Connect, in the Spotify appYour phone’s Bluetooth and audio outputs
Audio cacheAbout 500 MiB, automaticNoNo
Offline downloadsNoIn the Spotify appIn the Apple Music app
Library and search
AlbumsAllUp to 200All
SongsBy album, newest firstLiked Songs, up to 200Up to 500
PlaylistsAllUp to 200All, read-only
Favorites viewYour starred itemsNo, Songs is Liked SongsNo
Sort by Recently addedAlbums and playlistsAlbumsAlbums and playlists
SearchYour serverYour library or the Spotify catalogYour library or the Apple Music catalog
Playlists in searchNoYesYes
Queue
Play nextYesNoYes
Add to queueYesYesYes
Reorder the queueYesNoNo
Remove from the queueYesNoYes
Saving and playlists
Heart on a songStar on your serverLiked SongsNo heart. + adds it to your library.
AlbumsStarSave to libraryAdd songs one by one
ArtistsStarFollowNo
Create and edit playlistsYes, where you have permissionYes, where you have permissionNo
Delete a playlistDeletes it from the serverUnfollows itNo
ShareThe title, as textA Spotify linkA catalog link
Lyrics, ratings and sync
Lyrics found automaticallyFrom your serverQQ Music, NetEase, LRCLIBQQ Music, NetEase, LRCLIB
Song ratingsIn Yoin, and 0 to 5 stars on your serverIn YoinIn Yoin
Cloud sync finds the accountBy server and usernameBy Spotify user IDLink it once yourself

HelpTroubleshooting

Known issues

Feedback

Send feedback through the form. In Yoin, tap Send feedback: it’s on the account card, which opens from your picture on Home, and in Settings › About.

You can also write to lastnatsu51@gmail.com. It helps to include:

Leave out secretsDon’t include passwords, API keys or the address of a private server in screenshots or logs.

HelpPrivacy

Yoin has no Yoin account, no ads and no analytics. This is a short version; the full privacy policy has every detail.

On your phone

Your accounts (server addresses and usernames), passwords and sign-in tokens, ratings, notes, reviews, listening history, cached lyrics and your Gemini key are stored in Yoin’s private storage. Android backup can include the main database, such as ratings, notes and your Gemini key. Passwords and sign-ins are encrypted and kept out of backup.

What leaves your phone, and where it goes

ServiceWhenWhat it receives
Your music serverYou add itSign-in, library and search requests, streams, favorites and ratings
SpotifyYou connect itSign-in, catalog, library and playback requests
Apple MusicYou connect itApple ID sign-in and MusicKit requests
Yoin’s token serviceYou use it for Apple MusicA request for a developer token. No Apple ID or library data.
QQ Music, NetEase Cloud Music, LRCLIB, Huawei MusicYoin looks up lyrics (Huawei only when you search)Song title and artist, and what you type into lyrics search
Google GeminiYou saved a keySong details, lyrics to translate, your questions, listening facts for Memories, and the note or review a Memory title is written from
NeoDBYou connect itAlbum ratings and reviews. Long reviews are posted publicly.
Google DriveYou turn on Cloud syncThe sync file, in your own Drive
Google CastAlways, as part of playbackAnonymous Cast usage and performance data, sent by Google’s Cast SDK

Microphone

Yoin doesn’t record audio.

Deleting your data

Remove an account in Settings, clear Yoin’s storage, or uninstall it. Data on your server, Spotify, Apple Music, NeoDB or Google Drive is managed there.

Last updated October 2026. Spotify is a trademark of Spotify AB. Apple Music is a trademark of Apple Inc. Yoin is not affiliated with either.