maydo

logo Maydo

ci release GitHub Release

An Android video player built on mpv with yt-dlp inside: open a file, or give it the URL of a web page, and yt-dlp finds the stream that mpv plays.

Home Getting the stream with yt-dlp Player Tracks Settings yt-dlp and app updates

The video is Big Buck Bunny (CC BY 3.0, Blender Foundation).

Features

Development

mise and the Android SDK with NDK r28c (sdkmanager "ndk;28.2.13676358") required.

# first
mise install
mise generate git-pre-commit -w

mise run build
mise run test
mise run lint
mise run format

Build for distribution

# 1. Create the key (PKCS12, so the key password is the keystore password):
keytool -genkeypair -keystore release.jks -alias maydo -keyalg RSA -keysize 4096 -validity 36500

# 2. Fill in MAYDO_KEYSTORE_BASE64 and MAYDO_KEY_ALIAS:
cp .env.example .env
{
  echo "MAYDO_KEYSTORE_BASE64=$(base64 -w0 release.jks)"
  echo "MAYDO_KEY_ALIAS=maydo"
} >> .env

# 3. Add the two same passwords by hand: MAYDO_KEYSTORE_PASSWORD / MAYDO_KEY_PASSWORD
$EDITOR .env

# 4. Send everything to the repository's Actions secrets, and check it:
gh secret set --env-file .env
gh secret list

# 5. Test in local
mise run build:release

# 6. Tag: v<versionName>-<versionCode>, with a higher versionCode every time
git tag vX.Y.Z-N -m ... && git push origin vX.Y.Z-N

The release workflow attaches maydo-<version>-<abi>.apk for each ABI and a universal one; the in-app updater picks the one for the device’s ABI by that name.

License

MIT

app/src/main/assets/ytdl_hook.lua is a modified copy of mpv’s ytdl_hook.lua, under mpv’s LGPL-2.1-or-later.