Skip to content

Releases

Keyflow 2.0.0 · Clearer song status and a tidier Settings

Choose a tag to compare

@oskarsss oskarsss released this 18 Oct 21:30

Keyflow 2.0: clearer song status, a tidier Settings, and a clean start.

  • Songs that aren't downloaded yet are marked. A download badge on the Journey map tells them apart from songs that are ready. Tap it to see what happens next and follow the download live.
  • Step-by-step status. Tapping a song's badge opens a short explanation and a separate status card: each step (find, download, quick level, find the beat, place the tiles) with a check when it's done, a bar split into those steps, and the time left.
  • Settings, reorganised. Grouped into Gameplay, Timing and feel, Storage (space used and free, Song queues with what's waiting, and each playlist's downloads with a progress bar), Downloading, Free up space and Troubleshooting. Tap anywhere on a switch row to flip it; Remove after only shows while smart storage is on.
  • Update downloader now says when the downloader is already up to date.
  • Clean start. Code that kept data from earlier versions working is gone. If something looks off after updating, clear the app's data.

APKs, source archive and SHA-256 checksums are attached by the release workflow.

Keyflow 1.6.8 · Quick levels for every song, optional full levels

Choose a tag to compare

@oskarsss oskarsss released this 18 Oct 18:29

Every downloaded song is playable in seconds, and full levels are now optional.

  • Every downloaded song gets a quick level right away. The download worker makes one just after each download (Journey, Arcade and Download all alike), so you never wait minutes for the level worker. Songs already on the phone get one too. A level now counts as playable once its download and quick level are done, and the waiting times say so.
  • A badge shows which songs are on their quick level. A small half-disc on the next-up card and on the Journey map marks songs still waiting for their full level. Tap it to see what quick and full levels are, how far the full level has got (live), and where to turn full levels off.
  • Settings › Make full levels (on by default). Full levels are the higher quality tiling. Turning them off keeps only quick levels being made, saves battery, and stops a full level that is already being made.
  • Clear ALL downloaded songs is now labelled as such.

Development releases may reset app data. APKs, source archive and SHA-256 checksums are attached by the release workflow.

Keyflow 1.6.7 · Faster quick levels and downloads, clean cache

Choose a tag to compare

@oskarsss oskarsss released this 18 Oct 17:14

Quick levels in a couple of seconds, much faster downloads with a progress bar that moves, a cleaner cache, and song names in every mode.

  • Quick levels are about 15 times faster. They now find the beat with a simple signal-processing tracker instead of the beat model, which was nine tenths of the wait: about 2 seconds instead of about 30 on a test device. They still match about three quarters of the full level's tiles. When the full level has already found the beat, the quick level uses it.
  • Downloads skip the slow parts. The file itself took a second; most of the time went to solving YouTube's JavaScript challenge, starting the downloader and converting to MP3. Keyflow now asks as a YouTube client that needs no challenge (falling back to the usual way), keeps YouTube's own AAC audio instead of converting it (better quality, smaller files), and keeps the downloader ready between songs. The same song went from about 20 seconds to about 3. The progress bar now moves while it downloads instead of jumping from 0 to 100. Songs you already have are kept.
  • No more leftover cache. Temporary files from making levels and downloading are removed as soon as each job ends, and anything left by a job Android stopped is cleared on the next start. One test device got back about 110 MB.
  • Locked titles show their first five characters and ***.
  • Every level names its song under the countdown, with the mode's details below, in Journey and Endless too, not only Time Attack. Arcade keeps the titles of levels you haven't reached hidden.

Development releases may reset app data. APKs, source archive and SHA-256 checksums are attached by the release workflow.

Keyflow 1.6.6 · Quick levels that follow the music, and no stuck playlists

Choose a tag to compare

@oskarsss oskarsss released this 18 Oct 13:40

Quick levels that follow the music, no more playlists stuck on songs YouTube won't play, and no crash after long preparation.

  • Quick levels follow the music. Instead of a tile on every beat, a small model distilled from the full chart model picks tiles where the music actually hits, from onset strength in six frequency bands, the tile's place in the bar and the bar's loudness. A second one picks chords; holds come where the harmony rings on, and lanes follow the melody. On songs it never trained on it shares about 73% of the full level's tiles (the previous quick level: 43%), and about 84% on songs charted on a phone. It still takes seconds.
  • Songs YouTube won't play leave your playlists. A song that fails because the video is unavailable, private, removed, blocked in your country, age-restricted or members-only no longer blocks your next level by retrying every 15 minutes: it is taken out of every playlist, the next song takes its place, later imports skip it, and the home screen names the songs once. Songs that already failed this way go on the first start after the update. YouTube's "try again later" rate limit still retries.
  • No crash after long preparation. Android 15 gives background downloading six hours a day; when that runs out, preparation now stops cleanly instead of crashing, and opening the app starts it again.

Development releases may reset app data. APKs, source archive and SHA-256 checksums are attached by the release workflow.

Keyflow 1.6.5 · Two queues, quick levels and no stalls when the phone sleeps

Choose a tag to compare

@oskarsss oskarsss released this 18 Oct 12:22

Songs download and become levels side by side, quick levels let you carry on while a level is still being made, and preparation no longer stalls when the phone sleeps.

  • Two workers instead of one: one downloads songs, the other makes levels for songs already on the phone. Levels are made while the next songs download, and without a connection.
  • Download ahead on Wi-Fi only now holds back only downloads; songs already downloaded get their levels made on any connection. Only while charging still holds back both.
  • When a level's song is downloaded but its full level isn't ready, the loading screen offers Play now with a quick level: tiles on the beat, extra taps in loud parts, holds and chords, made in seconds. If the full level has already found the song's beat, the quick level is ready almost at once. The home screen mentions it, and the full level replaces it once it's made.
  • Settings › Song queues (was Download queue) shows two lists, Downloading and Preparing levels, each in order with an estimate. Playlist estimates count both workers running at once.
  • Preparation keeps the phone awake while it works and Wi-Fi at full speed during downloads, so locking the phone no longer stalls it. The hold is renewed per song for at most 30 minutes and released when both workers are done.
  • The opened song waits for an internet connection instead of failing when it isn't downloaded and the phone is offline.

Development releases may reset app data. APKs, source archive and SHA-256 checksums are attached by the release workflow.

Keyflow 1.6.4 · Your playlist first, a visible download queue and smaller APKs

Choose a tag to compare

@oskarsss oskarsss released this 17 Oct 17:12

A first start that begins with your own playlist, a download queue you can see, smaller APKs and a lighter touch while you play.

  • On the first start Keyflow asks for a YouTube Music playlist before anything else. While its songs become levels in the background, you can warm up with the three built-in songs; their home screen shows when your playlist's first level is ready and takes you there with one tap.
  • Settings › Download queue lists every song still to be downloaded and prepared, in the order the worker takes them, with its stage, an estimate of when it's ready, or what it waits for. Locked levels keep their hidden titles.
  • Download ahead and Download all wait for Wi-Fi by default, and can also wait for a charger. Your next two levels and Arcade always download. They start again on their own when Wi-Fi or a charger comes back while Keyflow is open.
  • While a game is on screen, preparation runs at about half speed so the game stays smooth. A song you're waiting for, and the next song of an Arcade run, aren't slowed.
  • Wait estimates learn download time and charting time separately, and take each song's length into account.
  • Chords are harder to get: linked tiles count as tapped together only within 35 ms of each other (was 65 ms).
  • A song that fails on its own no longer stops the rest of the queue; only lost connections pause it.
  • Releases come as one APK per processor: keyflow-1.6.4.apk for phones (about 170 MB, was 218 MB) and keyflow-1.6.4-x86_64.apk for emulators. The app is shrunk with R8 and starts faster with a baseline profile.
  • The chart models are read straight from the APK instead of being copied out, saving about 95 MB of storage. ONNX Runtime's start-up telemetry is removed, so the engine loads only when a song is charted.
  • Large playlists are read from disk only when they change, and preparation progress is no longer written to the playlist file every percent.

Development releases may reset app data. APKs, source archive and SHA-256 checksums are attached by the release workflow.

Keyflow 1.6.3 · One download queue, ready-to-play playlists

Choose a tag to compare

@oskarsss oskarsss released this 17 Oct 05:04

One download queue with clear priorities, playlists that say when they can be played, smooth large playlists and highlights that change each play.

  • All songs are now prepared by one worker in a fixed order: the song you opened and are waiting for, and the next song for an Arcade run you're playing when none is ready; then every playlist's next level and the locked one after it; then Arcade's 3 fresh songs; then each playlist's Download ahead window; and last, playlists set to Download all songs. A song from a lower step gives way when a higher one is missing, such as the new locked level after you clear one.
  • A playlist whose next level isn't on the phone yet is greyed out on the Playlists screen, with an estimate such as "playable in about 2 min". Its home screen dims Play and shows the same estimate. The estimate learns how long songs take on your phone.
  • Playlists with hundreds of songs open and scroll smoothly: the Journey map only builds the levels near the screen.
  • Long Journey levels have up to 5 good highlights of up to 2½ minutes, and each play takes a different one.
  • The first song of an Endless or Time Attack run no longer jumps when its audio starts late.
  • A song that fails because the connection dropped is retried after a minute; other failures wait 15 minutes, and a lost connection no longer fails every queued song at once.
  • Playlists and charts are written safely, so turning the phone off mid-save can't leave a playlist empty.
  • The code is reorganised into packages, with old-version handling removed and an architecture document.

Development releases may reset app data. APK, source archive and SHA-256 checksums are attached by the release workflow.

Keyflow 1.6.2 · Always ready to play

Choose a tag to compare

@oskarsss oskarsss released this 16 Oct 13:57

Smoother Endless starts, playlists that are always ready to play, and storage settings for each playlist.

  • Songs in Endless and Time Attack no longer start with tiles jumping back and pausing. Tiles keep moving while the music starts, then ease into its timing. The countdown now runs at the song's speed.
  • Every playlist keeps its next level and the locked one after it downloaded and charted, so playing on is never held up by a download. These come first in the download queue, and automatic cleanup never removes them.
  • Each playlist has its own settings page, opened with the gear on the Playlists screen. It shows how many of its songs are downloaded and the space they use. It also holds Download ahead, Keep downloaded songs (automatic cleanup leaves the playlist alone), Download all songs, Remove downloaded songs, Rename and Delete.
  • Settings → Storage and downloads shows the total songs and space used, with a row for each playlist that opens its settings.
  • Arcade plays songs from the Journey levels you have reached, so locked levels are not given away. Until you have reached 6 levels, it borrows the nearest locked ones.
  • Arcade keeps 3 fresh songs ready. Each song you play adds one new song to the mix, and songs Arcade has never played are downloaded first.
  • Arcade picks among the songs it played longest ago, so songs repeat less often. It starts getting songs ready from the home screen, after your Journey's downloads, so the first run already has variety.

Development releases may reset app data. APK, source archive and SHA-256 checksums are attached by the release workflow.

Keyflow 1.6.1 · Timing that learns your phone

Choose a tag to compare

@oskarsss oskarsss released this 16 Oct 08:48

Timing that learns your phone, and levels prepared ahead as you play.

  • PERFECT now follows where your taps actually land. After every song with at least 20 hits, Keyflow measures whether your taps leaned early or late and moves the timing offset toward it. Speaker, Bluetooth, touch-screen and display delay differ per phone. The results screen shows when the offset changed. It can be turned off in Settings, and the offset can still be set by hand in 5 ms steps.
  • Tiles move and are judged against a steady audio clock instead of the media player's coarse position steps.
  • Each tap is judged at the moment the finger touched the screen, not when the app received the event.
  • Levels ahead keep being prepared as you clear them, including when you go straight to "Next level". New playlists prepare 5 levels ahead.
  • Songs already on the phone whose charts came from an older generator are re-charted in the background, without needing a connection.
  • Song preparation shows one progress bar covering download, beat finding and tile placement, instead of stalling near the end. The notification shows the current song, its progress and how many songs are queued.
  • A song you open and wait for takes priority over background preparation. A finished download is kept and reused.

Development releases may reset app data. APK, source archive and SHA-256 checksums are attached by the release workflow.

Keyflow 1.6.0 · Human-chart-trained levels

Choose a tag to compare

@oskarsss oskarsss released this 16 Oct 00:03

Keyflow now prepares complete learned charts in the background before a song becomes playable. Opening a prepared level reads its saved tile locations and highlight without running chart inference.

  • Replaces the handwritten tile-pattern planner with the MIT-licensed Mapperatorinator-v32-mini mania checkpoint, trained upstream on community osu! charts and adapted for local Android inference.
  • Predicts note times, lanes and hold boundaries from audio and earlier chart context. Keeps the two-thumb safety gate and varied replay layouts.
  • Runs both rhythm and chart models on the phone; no server, API key or audio upload. Preparation progress is shown while music becomes ready.
  • Covers audible song intros that the pretrained model would otherwise leave empty.
  • Saves full charts and journey highlights atomically; interrupted preparations can retry, and existing audio is reused for chart version 6.

Validation: JVM tests, Android lint, model checksums, release-tool tests and native Android checks. See the included chart-learning documentation for measured results, reproducible conversion and limitations. This release adapts published pretrained weights; it does not claim new custom training or hand-authored quality for every song.

The larger APK includes both neural models and the existing offline runtime. Development releases may reset app data. APK, source archive and SHA-256 checksums are attached by the release workflow.