Repository navigation
Releases
BitChord 1.0.8
BitChord 1.0.8
Playback
- Fixes "Couldn't open a stream for that track" and "confirm you're not a bot" on networks where other YouTube clients still play. BitChord kept presenting the same YouTube identity once it had been flagged, so no retry, network or account could clear it. Each track is now asked for with a fresh anonymous identity, the way the working clients ask, and YouTube cookies are no longer stored.
- The YouTube extractor is updated to InnerTubeX 0.11.6.
- A track that fails is no longer asked for again in quick bursts, which could make a flagged network worse.
- Diagnostic reports now say which YouTube client refused a track and why.
Security
- rustls 0.23.46.
BitChord 1.0.7
BitChord 1.0.7
Automix
- Transitions are calmer on the CPU. Track analysis is paced so it no longer piles up with playback resolution, and each track is decoded once for analysis.
- Less memory during transitions. The Neural Engine beat model has a new version (v2) that holds about 370 MB less, and it is released shortly after use instead of lingering. Peaks drop from about 1.1 GB to about 700 MB.
- Installed Automix models update themselves when a newer version is pinned; the old one keeps working until the new one is verified. With Wi-Fi-only downloads on, a metered connection still waits for Wi-Fi.
Lyrics
- Untimed lyrics are aligned against the whole song, including songs in several languages and scripts without spaces.
- Lyrics on Player can be turned off in Settings.
Playback
- Songs start faster after launch: the prepared YouTube player is cached on disk.
- The playing-row bars and the title marquee use far less CPU, especially on Mac.
BitChord 1.0.6
BitChord 1.0.6
Now Playing
- A title too long for the player no longer widens it. On iPhone the player stayed pushed past the right edge, and on Mac the title spilled past the left. Long titles now stay in their column and scroll.
Updates
- Release notes now cover every version you skipped. The update sheet lists each release between your version and the latest, newest first, and the first launch after an update shows what changed since the version you last ran.
- Release notes are formatted: headings, lists, bold text, links and commands display properly instead of as raw Markdown.
- Mac: Check for Updates… is in the BitChord menu.
BitChord 1.0.5
BitChord 1.0.5
Artist pages
- Artist pages follow the YouTube Music layout: the name over the artwork, then Shuffle, a large Play button and Subscribe.
- Top songs have their own heading. Each shelf shows five items with Show all, and About comes last with the description, subscriber count and monthly listeners.
- Every credited artist on a song opens their own page, not only the first. Names without a link are matched exactly, or fall back to a search.
Now Playing
- The title and artist scroll when they don't fit, with the explicit mark, a star and a More button beside them. Tapping the title opens the album.
- Artwork follows the track that actually loaded, and old embedded artwork is cleared when the track changes.
- The playback source line sits centred in the timestamp row.
- Mac: opening the player from a pushed page, such as an artist page, no longer hides the sidebar with no way back. Closing the player returns you to that page.
Loading screens
- Loading placeholders now have the shape of the page they stand in for: Home shelves, library grids, artist and album pages, Explore tiles and song rows. They no longer jump or resize while they shimmer.
Playback and lyrics
- When playback fails while you are signed in, BitChord no longer asks you to sign in. A bot check is reported only when YouTube says so for every client; otherwise you get network advice.
- KuGou lyrics must match the track's artist and script, so an English song no longer gets another artist's Korean lyrics.
- Nested TTML markup no longer leaks into lyrics, and XML comments are ignored.
- Sign-in to YouTube Music asks which account to use.
Mac
- Single-click playback is now a setting (single or double click). The first click on an inactive window works, and typing in search keeps spaces and arrow keys.
- Toasts clear the playback pill, wrap instead of truncating, and stay up long enough to read.
- The compact navigation bar appears only in narrow windows.
Requirements
- iOS and iPadOS 18 or later. The IPA is unsigned: sign it with your own signing app and identity.
- macOS 15 or later on Apple Silicon. The DMG is ad-hoc signed; existing installs update through Sparkle.
AutoMix model: Beat This! final0 (Core ML, int8, v2)
Model asset for BitChord's AutoMix beat tracking on Apple devices. Not an app release.
beat_this_final0_coreml.aar: an Apple Archive containing BeatThisFinal0.mlpackage, a Core ML ML Program conversion of the full Beat This! model (final0, 20.25 M parameters) with int8 linear weight quantization. The app compiles it on device and runs it on the CPU and Neural Engine; the ONNX graph in model-beat-this-final0-v1 stays the fallback.
What changed from v1: the same weights, with attention computed in 150-row query blocks (the same algebra; fp32 parity with the original graph is unchanged at 128.9 / 131.1 dB). On the Neural Engine this holds about 90 MB of working buffers per loaded model instead of about 460 MB, and each 1500-frame window predicts slightly faster. Beat and downbeat peaks and BPM are identical to v1 on every parity track.
- Size: 18,826,124 bytes
- SHA-256:
cd00f20bd602f4d1532f0b683fe418f278affead3494f954032039d902b5b88f - Source weights: official CPJKU
final0checkpoint (81,058,141 bytes, SHA-2568c328b45f59d8dd3dff219253ff6a8d6482be57d0133a29140e2febbf8eb8331), model code CPJKU/beat_this at commitad79748 - Input
spectrogramFloat32[1, 1500, 128]log-mel →beat/downbeatFloat32 logits[1, 1500]; iOS 18 / macOS 15 - Reproducible with
scripts/coreml/convert_beat_this.py(same bytes from a clean environment)
Beat This! is © the CPJKU authors (Foscarin, Schlüter, Widmer), released under the MIT License: https://github.com/CPJKU/beat_this
BitChord 1.0.4
BitChord 1.0.4
Automix
- Beat detection now runs on the Neural Engine through Core ML. It is about four to five times faster on Apple Silicon and closer to the original model than before. Short tracks, and anything the Neural Engine can't take, fall back to the CPU.
- Both Automix models, the beat tracker and the vocal detector, are now optional downloads that are verified on the device. The app no longer bundles the vocal model, so it is smaller. BitChord offers them at launch and in Settings. Without them, Automix uses its built-in fallbacks.
- When a tempo glide ends, the waveform phase stays put. Tempo-aligned stretches keep stereo phase, and the bass in a transition is no longer lost.
- Analysis work is capped in CPU and memory, and stale analysis is cancelled.
Search
- A new Library source sits beside YouTube and Addons. It filters your signed-in library (songs, artists, albums, playlists) and the music on this device as you type, without network requests.
- iPad: a round search button grows into the search field. In portrait, the source switcher moves under the top bar.
- Mac: the search field, source switcher, account and Downloads sit in order in the title bar, and switching source re-runs the search.
iPad
- iPad now uses the system's adaptable sidebar, as Music does. It holds a Playlists section with Liked Music first, and the account and Settings at its foot.
- Each tab keeps a page history, with back and forward buttons beside the logo (and ⌘[ / ⌘]).
- The playback pill is capped at the mini-player width. In portrait, the volume row lines up with the Lyrics and Up Next buttons.
iPhone
- The player pill tucks into the minimized tab bar while you scroll, and rides above the keyboard.
Playback and sources
- Lossless streams are used whenever the quality setting is Lossless, whatever the output. As upstream does, Bluetooth only sidelines addons that require a lossless-capable output.
- Lossless sources are preferred before playback starts, and completed quality upgrades are confirmed. BitChord checks decoded formats, and interrupted playback recovers with a capped number of retries.
- Playback sessions are kept across restarts. Source lists survive storage read failures, and each source shows its check and renewal state.
- The JioSaavn catalogue and playback work again.
- Addon session renewal is opt-in and uses provider links you supply.
- Normalization headroom is back in Transparent playback, and explicit gapless repeat works.
- Audio settings now separate the requested quality, the measured output and the processing. The quality status is clearer, and the diagnostics refresh live.
Offline and downloads
- Downloads show per-song progress and pending states.
- Cached and downloaded songs keep their artwork, and covers come back after launch without network requests. Offline playback is kept.
Fixes
- Mac: the player's back button responds across its full visible area, and a crash in Settings is fixed.
- Videos start faster.
- Leaks during audio engine and interpreter teardown are fixed.
- The Liquid Glass icon draws its waves at full size.
- Version & Updates compares both version and build, and offers the installer for your platform.
Requirements
- macOS 15 or later on Apple Silicon.
- iOS or iPadOS 18 or later.
Downloads and installation
- Mac:
BitChord-1.0.4-build13-mac-arm64.dmg, an Apple Silicon DMG. It is ad-hoc signed, not notarized, and not Developer ID signed. Macs already running 1.0.1 or later can update from within the app. - iOS:
BitChord-1.0.4-build13-ios-unsigned.ipa, an unsigned IPA. Sideload it with AltStore, SideStore or Sideloadly, or sign it with your own Apple Developer team. release.json,SHA256.txtandINSTALL.mddescribe this pair of installers and their checksums.
Install on Mac
Drag BitChord to Applications, then open it. If Gatekeeper blocks the first launch, use either route:
-
System Settings: Open System Settings → Privacy & Security, scroll to Security, choose Open Anyway for BitChord, then confirm Open in the warning dialog.
-
Terminal: After moving BitChord to Applications, run:
xattr -dr com.apple.quarantine "/Applications/BitChord.app" open "/Applications/BitChord.app"
Sideload on iPhone or iPad
- Install AltStore, SideStore, or Sideloadly and connect the device as required by that tool.
- Import the unsigned IPA and sign it with your Apple account or developer team.
- Install the signed app and trust the developer profile if iOS asks.
To use iCloud lyrics-choice or sign-in sharing, sign the app with your own team and enable the matching iCloud Key-Value Store and iCloud Keychain capabilities and provisioning profile. Otherwise those features use local device storage.
Legal
BitChord does not host or provide media. Playback uses configured third-party services and their APIs; availability and terms are controlled by those services. See the README Disclaimer & Legal Notice.
Every GitHub release is built from its tagged commit, and that tag's source archive is the Corresponding Source under GPLv3 §6. The source for this release is the v1.0.4 tag.
Checksums (SHA-256)
b915c94a90a8fe69f2034e8f4fc54d06ef3f422bd8508b2b73f0a49d04839251 BitChord-1.0.4-build13-ios-unsigned.ipa
8a2edcfb1e76868297a4c7cef9e9d3a09bfaf8d9c43b061fa81e9d314bb85bff BitChord-1.0.4-build13-mac-arm64.dmg
AutoMix model: open-unmix umxhq vocals (int8)
Model asset for BitChord's AutoMix vocal analysis. Not an app release.
vocals_umxhq_int8.onnx: the open-unmix umxhq vocals model, exported to standard ONNX LSTM ops (opset 17) and dynamically quantized to int8 on MatMul/Gemm only.
- Size: 23,209,009 bytes
- SHA-256:
7eba6bebce0cc2e2d3b5c0e490a8074e66ce27f64170c6802b245740dcaf21ef - Source weights: official SigSep
umxhqvocals checkpointvocals-b62c91ce.pth(Zenodo record 3370489) - Input
mix_magnitude[1, 2, 2049, 960]STFT magnitude →target_magnitude[1, 2, 2049, 960]
open-unmix is © Fabian-Robert Stöter and Antoine Liutkus, released under the MIT License: https://github.com/sigsep/open-unmix-pytorch
AutoMix model: Beat This! final0 (Core ML, int8)
Model asset for BitChord's AutoMix beat tracking on Apple devices. Not an app release.
beat_this_final0_coreml.aar: an Apple Archive containing BeatThisFinal0.mlpackage, a Core ML ML Program conversion of the full Beat This! model (final0, 20.25 M parameters) with int8 linear weight quantization. The app compiles it on device and runs it on the CPU and Neural Engine; the ONNX graph in model-beat-this-final0-v1 stays the fallback.
- Size: 18,818,981 bytes
- SHA-256:
4f545c60ac59282bd8601104a94ff4123f5304d4e5e233311f6ec67243975fff - Source weights: official CPJKU
final0checkpoint (81,058,141 bytes, SHA-2568c328b45f59d8dd3dff219253ff6a8d6482be57d0133a29140e2febbf8eb8331), model code CPJKU/beat_this at commitad79748 - Input
spectrogramFloat32[1, 1500, 128]log-mel →beat/downbeatFloat32 logits[1, 1500]; iOS 18 / macOS 15 - Reproducible with
scripts/coreml/convert_beat_this.py(same bytes from a clean environment)
Beat This! is © the CPJKU authors (Foscarin, Schlüter, Widmer), released under the MIT License: https://github.com/CPJKU/beat_this
BitChord 1.0.3
BitChord 1.0.3
Sound
- Automix blends no longer open with a hissy stretch where neither song has its kick or bass line. The next song's low end now arrives as the previous song lets go of its own.
- Removed a tiny skip, about 3 ms, that came once in each Automix song shortly after the blend.
- Tempo matching during a blend is smoother on dense, bass-heavy records, uses about half the processing power, and lets go of the tempo sooner after the blend. Tempo differences too small to hear are no longer matched at all.
Requirements
- macOS 15 or later on Apple Silicon.
- iOS or iPadOS 18 or later.
Downloads and installation
- Mac: Apple Silicon DMG. It is ad-hoc signed, not notarized, and not Developer ID signed. Macs already running 1.0.1 or later can update from within the app.
- iOS: Unsigned IPA for sideloading with AltStore, SideStore, or Sideloadly, or for signing with your own Apple Developer team.
Install on Mac
Drag BitChord to Applications, then open it. If Gatekeeper blocks the first launch, use either route:
-
System Settings: Open System Settings → Privacy & Security, scroll to Security, choose Open Anyway for BitChord, then confirm Open in the warning dialog.
-
Terminal: After moving BitChord to Applications, run:
xattr -dr com.apple.quarantine "/Applications/BitChord.app" open "/Applications/BitChord.app"
Sideload on iPhone or iPad
- Install AltStore, SideStore, or Sideloadly and connect the device as required by that tool.
- Import the unsigned IPA and sign it with your Apple account or developer team.
- Install the signed app and trust the developer profile if iOS asks.
To use iCloud lyrics-choice or sign-in sharing, sign the app with your own team and enable the matching iCloud Key-Value Store and iCloud Keychain capabilities and provisioning profile. Otherwise those features use local device storage.
Legal
BitChord does not host or provide media. Playback uses configured third-party services and their APIs; availability and terms are controlled by those services. See the README Disclaimer & Legal Notice.
Every GitHub release is built from its tagged commit, and that tag's source archive is the Corresponding Source under GPLv3 §6. The source for this release is the v1.0.3 tag.
Checksums (SHA-256)
848c85bff818e3d692aef6505c65c894fbe68cf5ffed5f1e3c1de8298dc66b6d BitChord-1.0.3.dmg
244adc9abb4a6950883448c71bbb04aab44ef78b32655af03abe99d194c9ecfc BitChord-1.0.3-unsigned.ipa
BitChord 1.0.2
BitChord 1.0.2
Playback
- Playback no longer stops when a song can't be played. BitChord now tries several other ways to get the song first, including the same recording from another catalogue you have enabled. Only if all of them fail does it skip to the next song, which it prepares in advance so Automix still blends into it.
- A song that fails to load no longer stalls the queue. Autoplay and Automix now carry on to the next song.
- Moving the seek bar while Automix is blending two songs now jumps within the song you're hearing. Before, playback could go silent until the app was restarted.
- When YouTube asks your network to confirm it isn't a bot, BitChord now says so plainly and pauses its requests, instead of reporting every song as unplayable.
Sound
- Removed the crackle and hiss on kicks and bass in loud tracks. The default Transparent mode now gently turns down peaks that would go over full scale, instead of clipping them. Everything below full scale plays exactly as before.
- Automix raises a quieter next song by at most 2 dB, down from 6 dB, so blends don't overload loud masters.
- On iPhone and iPad, AirPods and other route changes no longer make playback stutter.
Discord
- Signing in to Discord now captures the session reliably, and the "Listening to" status reconnects on its own after sleep or a network change.
Addons
- Addon URLs keep their configured paths.
- On iOS, you can now remove an addon by swiping it, with a confirmation step.
- Better compatibility with addons: resource manifests, extra metadata field names, and streams that can't be played are declined cleanly.
Thanks to @Daltonganger for the addon fixes in #2, #3 and #4.
Requirements
- macOS 15 or later on Apple Silicon.
- iOS or iPadOS 18 or later.
Downloads and installation
- Mac: Apple Silicon DMG. It is ad-hoc signed, not notarized, and not Developer ID signed. Macs already running 1.0.1 can update from within the app.
- iOS: Unsigned IPA for sideloading with AltStore, SideStore, or Sideloadly, or for signing with your own Apple Developer team.
Install on Mac
Drag BitChord to Applications, then open it. If Gatekeeper blocks the first launch, use either route:
-
System Settings: Open System Settings → Privacy & Security, scroll to Security, choose Open Anyway for BitChord, then confirm Open in the warning dialog.
-
Terminal: After moving BitChord to Applications, run:
xattr -dr com.apple.quarantine "/Applications/BitChord.app" open "/Applications/BitChord.app"
Sideload on iPhone or iPad
- Install AltStore, SideStore, or Sideloadly and connect the device as required by that tool.
- Import the unsigned IPA and sign it with your Apple account or developer team.
- Install the signed app and trust the developer profile if iOS asks.
To use iCloud lyrics-choice or sign-in sharing, sign the app with your own team and enable the matching iCloud Key-Value Store and iCloud Keychain capabilities and provisioning profile. Otherwise those features use local device storage.
Legal
BitChord does not host or provide media. Playback uses configured third-party services and their APIs; availability and terms are controlled by those services. See the README Disclaimer & Legal Notice.
Every GitHub release is built from its tagged commit, and that tag's source archive is the Corresponding Source under GPLv3 §6. The source for this release is the v1.0.2 tag.
Checksums (SHA-256)
6ad88dc1ea397173279ac8f08deab99a9f947af9ecc26da5b9b6a0d74bc03df6 BitChord-1.0.2.dmg
b96c690b24a491db88a8f7af9272a75c42c39220a15699607d05f1d0df56968b BitChord-1.0.2-unsigned.ipa