Sign in
Downloads · Help

Install and verify

Opening a preview build on each system, checking a download, and how updates arrive.

Preview builds

The current builds are previews and are not code-signed yet, so macOS, Windows and Android ask before the first launch, and iPhone builds are installed with a sideloading tool. Check the file first (see Verify a download), then follow the steps for your system.

Download YunZheng Workspace · Download YunZheng Voice

macOS

  1. Open the DMG, drag the app into Applications, eject the disk, and open the app from Applications.
  2. When macOS says it cannot verify the developer, click Done.
  3. Open System Settings, then Privacy & Security, and click Open Anyway next to the message about the app. Confirm with your password.

On macOS 14 and earlier you can instead Control-click the app, choose Open, then Open again. If macOS says the app is damaged, run this in Terminal and open it again:

xattr -dr com.apple.quarantine "/Applications/YunZheng Voice.app"

Apple silicon Macs take the Apple silicon DMG; Intel Macs take the Universal DMG, which runs on both.

Windows

Run the installer. If Microsoft Defender SmartScreen shows "Windows protected your PC", click More info, check that the file name matches the one you downloaded, and click Run anyway. One installer covers x64 and Arm64 PCs; the ZIP runs without installing.

Android

  1. Download the APK on the phone and open it.
  2. When Android asks, allow your browser or file manager to install unknown apps, go back, and tap Install.
  3. If Play Protect warns about an app from outside Google Play, choose Install anyway.

When the apps reach Google Play, the Play copies are signed differently: Android cannot update one from the other. Uninstall the preview before installing from Google Play, and the other way round. Your account data stays with YunZheng.

iPhone and iPad

The iPhone builds are installed with a sideloading tool, which signs the app with your own Apple ID. Each tool needs a computer for the first install. On iOS 16 or later, turn on Developer Mode after the first install (Settings, Privacy & Security, Developer Mode) and restart when asked.

AltStore

Install AltServer on a Mac or Windows PC and use it to install AltStore on the iPhone (guide at altstore.io). Copy the IPA to the iPhone, then in AltStore open My Apps, tap +, and choose it. Keep AltServer running on the same Wi-Fi so AltStore can refresh the app.

SideStore

Install SideStore by following sidestore.io. After setup it refreshes apps on the phone, with no computer. In SideStore open My Apps, tap +, and choose the IPA.

Sideloadly

Install Sideloadly on a Mac or Windows PC, connect the iPhone with a cable, drag the IPA into Sideloadly, enter your Apple ID and click Start. Then on the iPhone open Settings, General, VPN & Device Management, and trust your developer profile.

With a free Apple ID

  • The app stops opening after 7 days unless it is refreshed; AltStore and SideStore can refresh it for you.
  • At most 3 sideloaded apps can be active at a time, and AltStore or SideStore counts as one.
  • At most 10 app IDs can be created in 7 days.
  • There are no push notifications: YunZheng Voice rings for incoming calls only while it is open or running in the background.

The mainland China edition of YunZheng Voice shows incoming calls as notifications instead of the system call screen. TestFlight builds are coming.

Verify a download

Each app's download page shows the SHA-256 checksum of every file under Checksum, and each release has a SHA256SUMS file. Compare the value for your file:

shasum -a 256 YunZheng-Voice-*.dmg                        # macOS
Get-FileHash .\YunZheng-Voice-*.exe -Algorithm SHA256    # Windows PowerShell
sha256sum -c SHA256SUMS --ignore-missing                   # Linux

How updates arrive

  • macOS and Windows: the apps check for new versions and update after you confirm. On Windows the app closes, updates and opens again. On macOS, while the builds are not signed, the new version opens as a disk image to drag into Applications. Settings, Updates lets you choose the stable or beta channel.
  • Android: the app checks for new versions and installs them through Android's installer after you confirm. Copies from Google Play are updated by Google Play.
  • iPhone and iPad: an AltStore and SideStore source arrives with the first release; the app also shows when an update is available.

Questions

How do I open YunZheng on a Mac when macOS says it cannot verify the developer?
Open System Settings, then Privacy & Security, and click Open Anyway next to the message about the app.
What do I do when Windows SmartScreen says Windows protected your PC?
Click More info, check the file name, and click Run anyway.
How do I install the Android APK?
Open the APK on the phone, allow your browser or file manager to install unknown apps when asked, then tap Install.
How do I install YunZheng on an iPhone?
Use AltStore, SideStore or Sideloadly, which sign the IPA with your own Apple ID. With a free Apple ID the app must be refreshed every 7 days.
How do I check a download?
Compare the file's SHA-256 with the value under Checksum on the download page or in the release's SHA256SUMS file.