Open-source music player for YouTube Music's catalog, with genres, full albums and playlists. Windows, macOS, Linux, Android, iPhone and Docker. No account needed.
TypeScript
feat(ios): ship the iPhone app with each release (1.5.0)
Ernanib320573b3da4
diff --git a/.github/workflows/release.yml b/.github/workflows/release.ymlindex 35c235d..60d7380 100644--- a/.github/workflows/release.yml+++ b/.github/workflows/release.yml@@ -1,5 +1,6 @@# Builds every download for a release tag (v1.4.0) and attaches them to a draft GitHub release:-# the Windows installer, the macOS apps (Apple Silicon and Intel), the Linux packages and the Android APK.+# the Windows installer, the macOS apps (Apple Silicon and Intel), the Linux packages, the Android APK and the+# unsigned iOS app.# The draft only goes public when it's published by hand, after checking it.## The APK is signed with the key in these repository secrets (Settings → Secrets and variables → Actions):@@ -131,8 +132,32 @@ jobs:path: release/*if-no-files-found: error+ ios:+ runs-on: macos-15+ steps:+ - uses: actions/checkout@v5+ - uses: pnpm/action-setup@v5+ - uses: actions/setup-node@v5+ with:+ node-version: 22+ cache: pnpm+ - run: pnpm install --frozen-lockfile+ # Unsigned on purpose: AltStore, SideStore or Sideloadly sign it with the user's own Apple ID when installing.+ - run: pnpm --filter @musike/mobile ipa+ - name: Check downloads+ shell: bash+ run: |+ { echo "### iOS"; ls release | sed 's/^/- /'; } >> "$GITHUB_STEP_SUMMARY"+ found=$(ls release/*-iOS.ipa 2>/dev/null | wc -l)+ [ "$found" -eq 1 ] || { echo "::error::Expected 1 file(s) matching *-iOS.ipa, found $found"; ls -l release; exit 1; }+ - uses: actions/upload-artifact@v7+ with:+ name: ios+ path: release/*+ if-no-files-found: error+release:- needs: [windows, mac, linux, android]+ needs: [windows, mac, linux, android, ios]if: startsWith(github.ref, 'refs/tags/v')runs-on: ubuntu-latestpermissions:diff --git a/README.md b/README.mdindex 1c4c5d3..406ceab 100644--- a/README.md+++ b/README.md@@ -7,18 +7,18 @@**Your music, uninterrupted.**A personal music player for YouTube's catalog: any song or music video, as **audio** or **video**, with no ads, no account and no subscription.-Runs as a **Windows**, **macOS** and **Linux** app, as an **Android** and **Android TV** app that needs no computer, in any **browser** (installable PWA) and in **Docker**.+Runs as a **Windows**, **macOS** and **Linux** app, as an **Android**, **Android TV** and **iPhone** app that needs no computer, in any **browser** (installable PWA) and in **Docker**.-+<img src="docs/screenshots/home.jpg" alt="Musike playing Radiohead, with playlists, recently played and the Now Playing panel" width="900" />-**[Download for Windows, macOS, Linux and Android](https://github.com/Ernani1234/musike/releases/latest)** · [Run with Docker](#option-5-docker) · [Run from source](#option-6-node-server--browser)+**[Download for Windows, macOS, Linux, Android and iPhone](https://github.com/Ernani1234/musike/releases/latest)** · [Run with Docker](#option-6-docker) · [Run from source](#option-7-node-server--browser)</div>@@ -86,10 +86,11 @@ Musike started from the idea behind the old Discord music bots: a server that fe- Updating keeps your library (it's backed up automatically before each update)- Downloads and maintains the tools it needs (yt-dlp, Deno, FFmpeg)-**Android app**+**Android and iPhone apps**- **Standalone:** no computer, no server. The phone searches YouTube Music and plays the audio straight from YouTube- Same app as on the computer: search, genres, artists, albums, Search a list, playlists, favorites, themes and colors- Keeps playing with the screen off, with controls in the notification, on the lock screen and on headphones; pauses for calls and when headphones are unplugged+- **iPhone:** the same app for iOS, installed with AltStore, SideStore or Sideloadly- **Android TV:** the same app appears in the TV launcher and switches to a bigger interface you navigate with the remote- Audio only for now (no video mode)@@ -221,7 +222,20 @@ On the phone, download `Musike-Setup-<version>-Android.apk` from the [latest relTo build the APK yourself you need JDK 21 and the Android SDK (Android Studio installs both): `pnpm install && pnpm --filter @musike/mobile apk` (creates `release/Musike-Setup-<version>-Android.apk`; unsigned unless `mobile/android/keystore.properties` points to your signing key).-### Option 5: Docker+### Option 5: iPhone app++Download `Musike-Setup-<version>-iOS.ipa` from the [latest release](https://github.com/Ernani1234/musike/releases/latest). Apple only lets App Store apps install directly, so the file comes unsigned and is signed with your own Apple ID as you install it, using one of these free tools:++- **AltStore** or **SideStore:** install the store on the iPhone, then open the `.ipa` with it.+- **Sideloadly:** on a Windows or Mac computer, connect the iPhone and drag the `.ipa` into it. Then trust your Apple ID in **Settings > General > VPN & Device Management**.++On iOS 16 and newer, also turn on **Settings > Privacy & Security > Developer Mode** the first time. With a free Apple ID the app has to be signed again every 7 days; AltStore and SideStore do it on their own in the background. Requires iOS 15 or newer.++Like on Android, it works on its own (no computer or server), keeps playing with the screen locked, and has controls on the lock screen, in Control Center and on headphones. Audio only for now.++To build it yourself on a Mac with Xcode: `pnpm install && pnpm --filter @musike/mobile ipa` (creates `release/Musike-Setup-<version>-iOS.ipa`).++### Option 6: DockerFor a home server, NAS or Raspberry Pi. The image (amd64 and arm64) includes yt-dlp, Deno and FFmpeg.@@ -253,7 +267,7 @@ Or with plain Docker: `docker run -d -p 4180:4180 -v musike-data:/data -v musike> **Run it at home, not on a VPS:** YouTube blocks datacenter IPs ("Sign in to confirm you're not a bot"). A home server uses your residential IP.-### Option 6: Node server + browser+### Option 7: Node server + browserRequirements:@@ -402,7 +416,7 @@ musike/│ ├─ tv/ Android TV: remote (D-pad) navigation and the 10-foot interface│ └─ stores/ state (zustand), appearance preferences├─ desktop/ Electron: window, built-in server, Windows installer, macOS and Linux packages-├─ mobile/ Android app (Capacitor): playback service, signing, streaming.json+├─ mobile/ Android and iOS apps (Capacitor): native playback, signing, streaming.json├─ Dockerfile server + web app image (amd64, arm64)└─ docs/ UX benchmark, design system and screenshots```@@ -450,6 +464,7 @@ iOS limits background playback for PWAs; Audio mode works better than Video.- [x] macOS app- [x] Linux app- [x] Android app (audio)+- [x] iPhone app (audio, sideloaded)- [ ] Cloud sync for the library (today: [backup to a file](#moving-your-library-backup))- [ ] Import YouTube playlists from a link- [ ] Video mode on Androiddiff --git a/desktop/package.json b/desktop/package.jsonindex 8cbdcd8..cdc629f 100644--- a/desktop/package.json+++ b/desktop/package.json@@ -1,7 +1,7 @@{"name": "musike-desktop","productName": "Musike",- "version": "1.4.2",+ "version": "1.5.0","description": "Your music, uninterrupted.","author": "Musike","homepage": "https://github.com/Ernani1234/musike",diff --git a/mobile/android/app/capacitor.build.gradle b/mobile/android/app/capacitor.build.gradleindex d70a2b0..85a212d 100644--- a/mobile/android/app/capacitor.build.gradle+++ b/mobile/android/app/capacitor.build.gradle@@ -11,6 +11,7 @@ apply from: "../capacitor-cordova-android-plugins/cordova.variables.gradle"dependencies {implementation project(':capacitor-app')implementation project(':capacitor-filesystem')+ implementation project(':capacitor-keyboard')implementation project(':capacitor-share')}diff --git a/mobile/android/capacitor.settings.gradle b/mobile/android/capacitor.settings.gradleindex 04075c5..3391cef 100644--- a/mobile/android/capacitor.settings.gradle+++ b/mobile/android/capacitor.settings.gradle@@ -8,5 +8,8 @@ project(':capacitor-app').projectDir = new File('../../node_modules/.pnpm/@capacinclude ':capacitor-filesystem'project(':capacitor-filesystem').projectDir = new File('../../node_modules/.pnpm/@[email protected]_@[email protected]/node_modules/@capacitor/filesystem/android')+include ':capacitor-keyboard'+project(':capacitor-keyboard').projectDir = new File('../../node_modules/.pnpm/@[email protected]_@[email protected]/node_modules/@capacitor/keyboard/android')+include ':capacitor-share'project(':capacitor-share').projectDir = new File('../../node_modules/.pnpm/@[email protected]_@[email protected]/node_modules/@capacitor/share/android')diff --git a/mobile/capacitor.config.ts b/mobile/capacitor.config.tsindex 02f5c13..6a1e86b 100644--- a/mobile/capacitor.config.ts+++ b/mobile/capacitor.config.ts@@ -23,9 +23,9 @@ const config: CapacitorConfig = {...(serverUrl ? { server: { url: serverUrl, cleartext: false } } : {}),plugins: {Keyboard: {- // The web view shrinks with the keyboard, so the search box and its results stay in view.+ // iOS: the web view shrinks with the keyboard, so the search box and its results stay in view. (Android already+ // makes room through SystemBars; its resizeOnFullScreen workaround would shrink the page a second time.)resize: "native",- resizeOnFullScreen: true,},SystemBars: {// The app already pads itself with env(safe-area-inset-*), like on an iPhone.diff --git a/mobile/ios/App/App.xcodeproj/project.pbxproj b/mobile/ios/App/App.xcodeproj/project.pbxprojindex 1f816b4..9952cab 100644--- a/mobile/ios/App/App.xcodeproj/project.pbxproj+++ b/mobile/ios/App/App.xcodeproj/project.pbxproj@@ -316,14 +316,14 @@buildSettings = {ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;CODE_SIGN_STYLE = Automatic;- CURRENT_PROJECT_VERSION = 10402;+ CURRENT_PROJECT_VERSION = 10500;INFOPLIST_FILE = App/Info.plist;IPHONEOS_DEPLOYMENT_TARGET = 15.0;LD_RUNPATH_SEARCH_PATHS = ("$(inherited)","@executable_path/Frameworks",);- MARKETING_VERSION = 1.4.2;+ MARKETING_VERSION = 1.5.0;OTHER_SWIFT_FLAGS = "$(inherited) \"-D\" \"COCOAPODS\" \"-DDEBUG\"";PRODUCT_BUNDLE_IDENTIFIER = app.musike.ios;PRODUCT_NAME = "$(TARGET_NAME)";@@ -338,14 +338,14 @@buildSettings = {ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;CODE_SIGN_STYLE = Automatic;- CURRENT_PROJECT_VERSION = 10402;+ CURRENT_PROJECT_VERSION = 10500;INFOPLIST_FILE = App/Info.plist;IPHONEOS_DEPLOYMENT_TARGET = 15.0;LD_RUNPATH_SEARCH_PATHS = ("$(inherited)","@executable_path/Frameworks",);- MARKETING_VERSION = 1.4.2;+ MARKETING_VERSION = 1.5.0;PRODUCT_BUNDLE_IDENTIFIER = app.musike.ios;PRODUCT_NAME = "$(TARGET_NAME)";SWIFT_ACTIVE_COMPILATION_CONDITIONS = "";diff --git a/mobile/package.json b/mobile/package.jsonindex 4a69e14..428bf5d 100644--- a/mobile/package.json+++ b/mobile/package.json@@ -1,14 +1,15 @@{"name": "@musike/mobile","private": true,- "version": "1.4.2",+ "version": "1.5.0","description": "Musike for Android: the web app with the server's work done on the phone (Capacitor).","type": "module","scripts": {"build": "pnpm --filter @musike/web build:native && cap sync android","apk": "pnpm run build && node scripts/build-apk.mjs","ipa": "node scripts/build-ipa.mjs",- "open": "cap open android"+ "open": "cap open android",+ "open:ios": "cap open ios"},"dependencies": {"@capacitor/android": "8.5.3",diff --git a/mobile/scripts/build-ipa.mjs b/mobile/scripts/build-ipa.mjsindex 9679641..fa2e57b 100644--- a/mobile/scripts/build-ipa.mjs+++ b/mobile/scripts/build-ipa.mjs@@ -1,10 +1,10 @@-// Builds the iOS app as an unsigned .ipa and copies it to release/Musike-iOS-<version>.ipa at the repository root,+// Builds the iOS app as an unsigned .ipa and copies it to release/Musike-Setup-<version>-iOS.ipa at the repository root,// next to the desktop and Android downloads.// Needs macOS with Xcode 15+ (xcodebuild). The .ipa is not signed on purpose: Sideloadly, AltStore, TrollStore and// friends sign it with the user's own certificate when installing.//// MUSIKE_SERVER_URL=https://musike.example.com builds the app against that Musike server instead of the backend-// inside the app; the file is then named Musike-iOS-<version>-server.ipa.+// inside the app; the file is then named Musike-Setup-<version>-iOS-server.ipa.import { spawnSync } from "node:child_process";import { existsSync, mkdirSync, readFileSync, rmSync } from "node:fs";import { dirname, join } from "node:path";@@ -12,6 +12,9 @@ import { fileURLToPath } from "node:url";const root = join(dirname(fileURLToPath(import.meta.url)), "..");const { version } = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));+// One version for the whole app, as on Android: mobile/package.json (1.5.0 becomes build 10500).+const [major, minor, patch] = version.split(".").map((n) => parseInt(n, 10) || 0);+const build = String(major * 10000 + minor * 100 + patch);const app = join(root, "ios", "App");const work = join(root, "ios", "build");const archive = join(work, "Musike.xcarchive");@@ -22,9 +25,10 @@ const run = (cmd, args, cwd = app) => {if (r.status !== 0) process.exit(r.status ?? 1);};-// The web app with the backend running inside the app, then the copy Capacitor makes of it for the Xcode project.+// The web app with the backend running inside the app, then the copy Capacitor makes of it for the Xcode project+// (from the folder with capacitor.config.ts).run("pnpm", ["--filter", "@musike/web", "build:native"], join(root, ".."));-run("pnpm", ["exec", "cap", "sync", "ios"]);+run("pnpm", ["exec", "cap", "sync", "ios"], root);run("xcodebuild", ["-project", "App.xcodeproj","-scheme", "App",@@ -35,6 +39,8 @@ run("xcodebuild", ["CODE_SIGNING_ALLOWED=NO","CODE_SIGNING_REQUIRED=NO","CODE_SIGN_IDENTITY=",+ `MARKETING_VERSION=${version}`,+ `CURRENT_PROJECT_VERSION=${build}`,]);// An .ipa is a zip with the app bundle inside Payload/.@@ -47,7 +53,7 @@ rmSync(staging, { recursive: true, force: true });mkdirSync(join(staging, "Payload"), { recursive: true });run("cp", ["-R", bundle, join(staging, "Payload", "Musike.app")]);const suffix = process.env.MUSIKE_SERVER_URL ? "-server" : "";-const target = join(root, "..", "release", `Musike-iOS-${version}${suffix}.ipa`);+const target = join(root, "..", "release", `Musike-Setup-${version}-iOS${suffix}.ipa`);mkdirSync(dirname(target), { recursive: true });rmSync(target, { force: true });run("zip", ["-qry", target, "Payload"], staging);diff --git a/mobile/streaming.json b/mobile/streaming.jsonindex 340c9ac..ed06e27 100644--- a/mobile/streaming.json+++ b/mobile/streaming.json@@ -1,3 +1,4 @@{- "clients": ["VISIONOS"]+ "clients": ["VISIONOS"],+ "ios": ["IOS", "VISIONOS"]}diff --git a/package.json b/package.jsonindex d59ec92..0f92fc3 100644--- a/package.json+++ b/package.json@@ -1,7 +1,7 @@{"name": "musike","private": true,- "version": "1.4.2",+ "version": "1.5.0","type": "module","scripts": {"dev": "pnpm --parallel --filter ./server --filter ./web dev",diff --git a/server/package.json b/server/package.jsonindex ac0a595..50fa36a 100644--- a/server/package.json+++ b/server/package.json@@ -1,7 +1,7 @@{"name": "@musike/server","private": true,- "version": "1.4.2",+ "version": "1.5.0","type": "module","scripts": {"dev": "tsx watch --clear-screen=false src/index.ts",diff --git a/web/package.json b/web/package.jsonindex f260027..022edee 100644--- a/web/package.json+++ b/web/package.json@@ -1,7 +1,7 @@{"name": "@musike/web","private": true,- "version": "1.4.2",+ "version": "1.5.0","type": "module","scripts": {"dev": "vite --host",