Reading the repo
Opening the box…
Reading the repo
Opening the box…
Assembly instructions
YouDash brings native YouTube to Apple CarPlay with YouMod ad blocking, responsive layouts, and an on-screen keyboard. Open-source iOS integration. Formerly YouTube Car.
Saved setup from 20 h ago
Will it work on macOS?
docs/BUILD.mdxcode-select -p), an iPhoneOS SDK, and command-line tools.python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements-build.txt
python3 scripts/build_carplay.py --compile-only
The last command produces build/YouTubeCarPlay.dylib. It compiles the module without changing or installing an app.
python3 scripts/build_carplay.py --ipa /path/to/YouMod.ipa --unsigned --bundle-id com.example.youtubecar --reported-version 21.45.4
com.example.youtubecar is a placeholder. Use your own identifier when signing. Outputs are dist/YouTube.app, dist/YouTubeCarPlay-21.42.4-unsigned.ipa, and a hash/version manifest. The output name uses the actual version; the bundle reports the compatibility value. To use the unmodified input version instead, pass --reported-version native.
The unsigned path does not read your signing profiles or certificates. It strips embedded provisioning profiles and signatures from nested binaries and the app. It still contains Google's and the input provider's proprietary binaries; their rights remain separate from our source license.
First create an app ID/profile through your own authorized developer setup. Match the bundle ID to that profile. Import its certificate/private key into Keychain using your usual secure process; do not copy them into this repository.
xcrun devicectl list devices
python3 scripts/build_carplay.py --ipa /path/to/YouMod.ipa --profile /path/to/your.mobileprovision --bundle-id com.example.youtubecar --device YOUR_DEVICE_UDID
Use your own UDID locally. The script checks profile/device membership, compiles the module, injects it through cyan, signs nested code, verifies signatures, then installs and launches. It uses only the profile's permitted entitlements and does not copy foreign application groups. Missing CarPlay capabilities require an authorized profile; changing a plist or installing with a sideloader does not grant them.
After a signed package has been created in dist/YouTube.app:
python3 scripts/update_carplay_module.py --device YOUR_DEVICE_UDID
Metadata-only version changes can reuse the module:
python3 scripts/update_carplay_module.py --device YOUR_DEVICE_UDID --reported-version 21.45.4 --reuse-module
python3 scripts/update_carplay_module.py --device YOUR_DEVICE_UDID --restore-reported-version --reuse-module
Actual input version fields are retained under YCPActualYouTubeVersion and YCPActualYouTubeBuild. Do not use the displayed compatibility value to identify the underlying executable.
YouTubeCarPlay.dylib, changes app identity, enables audio background mode, and sets the reported-version compatibility fields.The YouFixPlaybackIssues TV-client patch is excluded from this working baseline. YouMod's ad-blocking behavior is retained. No alternative player is installed.
The compiled YouMod in the input IPA is reused. vendor/YouMod/ is the attributed source snapshot for inspection and modification. Editing it does not change an existing dylib. To rebuild it, use Theos with the upstream headers/dependencies and the original build instructions in vendor/YouMod/README.md; then provide an IPA containing your newly built YouMod. This repository's module build does not pretend to rebuild Google or every third-party tweak from source.
.venv and install requirements-build.txt. The script runs cyan with the current Python interpreter.COMPATIBILITY.md.These are not required for an end user to install. The native harnesses require a booted iOS simulator:
python3 -m unittest discover -s tests -v
python3 tests/run_native_surface.py YOUR_SIMULATOR_UDID
python3 tests/run_watch_layout.py YOUR_SIMULATOR_UDID
git clone https://github.com/sa4hnd/YouDash.git
cd YouDash
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements-build.txt
python3 scripts/build_carplay.py --compile-only
This builds build/YouTubeCarPlay.dylib. To package your own compatible input and install on your registered iPhone:
python3 scripts/build_carplay.py \
--ipa /path/to/YouMod.ipa \
--profile /path/to/your.mobileprovision \
--bundle-id com.example.youtubecar \
--device YOUR_DEVICE_UDID
Use your own bundle ID, profile, and device ID. For an unsigned IPA, replace --profile and --device with --unsigned. The builder checks the input, compiles the module, injects it, and packages the result. The signed path also installs and launches the app.
Full build guide → — prerequisites, unsigned export, signing, module updates, and troubleshooting.
Your provisioning profile must permit:
<key>com.apple.developer.carplay-video</key>
<true/>
Adding this text to a file does not grant the capability. Obtain the required capability through an authorized Apple developer provisioning setup. The project does not supply signing credentials or bypass entitlement authorization. Vehicle and OS support are also required.
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/sa4hnd/YouDash.git cd YouDash
Python 3
brew install python
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
python3 -m venv .venv source .venv/bin/activate python3 -m pip install -r requirements-build.txt python3 scripts/build_carplay.py --compile-only python3 scripts/build_carplay.py \ --ipa /path/to/YouMod.ipa \ --profile /path/to/your.mobileprovision \ --bundle-id com.example.youtubecar \ --device YOUR_DEVICE_UDID
No reports for macOS yet.
GitManual AI Agent reads the 2 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.