Skip to content

VoiceStudio is the open-source, fully-local ElevenLabs alternative — voice cloning, voice design, video dubbing, dictation, transcription & audiobook creation in 646 languages.

docs(store): prepare the Google Play listing for the Android app

velixiocde12f80619f
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 635c46ea4..55a416da4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -94,6 +94,7 @@ metadata and the backend fallback mirror it.
### Docs
+- Google Play store listing, graphics and Play Console answers for the Android app are ready for the owner to submit (#PR)
- `SPONSORS.md` now states what each sponsorship tier gives, when recognition starts, and what sponsorship does not buy, and the README and inquiry form point to it (#3172)
- OmniVoice GGUF docs state that the installers do not ship its native binary yet (#3026) — thanks @DestinyQJY!
- Contributor guides and the pull request template explain how to sign the CLA before opening a first pull request (#2676)
diff --git a/docs/mobile.md b/docs/mobile.md
index a03055083..dcf4a8e4b 100644
--- a/docs/mobile.md
+++ b/docs/mobile.md
@@ -144,7 +144,8 @@ number and attempt, so every upload is new.
The `Android Play internal testing` workflow is the Android counterpart: it
signs a release bundle with the Play upload key and uploads it to the Play
Console **internal testing** track. It is dispatched by hand from `main` and
-never sends a release to production. One-time setup:
+never sends a release to production. The store listing, graphics and Play Console
+answers are in [`store/google-play.md`](../store/google-play.md). One-time setup:
1. Create the app in the Play Console with the package name
`sh.voicestudio.mobile` and keep Play App Signing on (Google holds the app
diff --git a/scripts/create_google_play_assets.py b/scripts/create_google_play_assets.py
new file mode 100644
index 000000000..ebe624019
--- /dev/null
+++ b/scripts/create_google_play_assets.py
@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+"""Render the Google Play icon and feature graphic from the repo's brand sources.
+
+Inputs are the app logo, the phone Home artwork, the generated dark theme and the
+bundled Inter font, so the store graphics follow the app instead of a hand edit.
+"""
+import json
+from pathlib import Path
+
+from PIL import Image, ImageDraw, ImageFont, ImageOps
+
+ROOT = Path(__file__).resolve().parents[1]
+OUT = ROOT / "store/google-play"
+FONT = ROOT / "mobile/android/core/designsystem/src/main/res/font/inter_variable.ttf"
+FEATURE_SIZE = (1024, 500)
+
+
+def dark_colors():
+ palettes = json.loads((ROOT / "mobile/contract/tokens.json").read_text())["palettes"]
+ colors = next(p for p in palettes if p["id"] == "default")["colors"]["dark"]
+ return {k: "#" + v[1:7] for k, v in colors.items()}
+
+
+def font(size, weight):
+ face = ImageFont.truetype(str(FONT), size)
+ axes = face.get_variation_axes()
+ face.set_variation_by_axes([weight if axis["name"] in (b"Weight", "Weight") else axis["default"] for axis in axes])
+ return face
+
+
+def icon():
+ # Play masks a full-bleed square, so draw what the adaptive launcher icon shows
+ # (mobile/android/scripts/generate_brand_resources.py): the logo scaled to 0.9
+ # of 64 units, 25.2 units in from each edge of 108, on the theme canvas.
+ size, scale = 512, 512 / 108
+ image = Image.new("RGB", (size, size), dark_colors()["canvas"])
+ side = round(64 * 0.9 * scale)
+ logo = Image.open(ROOT / "docs/logo.png").convert("RGBA").resize((side, side), Image.LANCZOS)
+ image.paste(logo, (round(25.2 * scale),) * 2, logo)
+ return image
+
+
+def feature_graphic():
+ colors = dark_colors()
+ art = Image.open(ROOT / "electron/public/signal-field.webp").convert("RGB")
+ art = ImageOps.fit(art, FEATURE_SIZE, Image.LANCZOS)
+ # Darken the left side so the wordmark stays readable over the artwork.
+ shade = Image.linear_gradient("L").rotate(90).resize(FEATURE_SIZE)
+ image = Image.composite(art, Image.new("RGB", FEATURE_SIZE, colors["canvas"]), shade)
+ logo = Image.open(ROOT / "docs/logo.png").convert("RGBA").resize((132, 132), Image.LANCZOS)
+ image.paste(logo, (72, 112), logo)
+ draw = ImageDraw.Draw(image)
+ draw.text((72, 270), "VoiceStudio", font=font(76, 700), fill=colors["text"])
+ draw.text((74, 366), "Voice cloning, dictation and dubbing on your phone",
+ font=font(28, 500), fill=colors["text"])
+ draw.text((74, 408), "Runs offline once models are downloaded", font=font(24, 400), fill=colors["textMuted"])
+ return image
+
+
+def main():
+ OUT.mkdir(parents=True, exist_ok=True)
+ icon().save(OUT / "icon-512.png", optimize=True)
+ feature_graphic().save(OUT / "feature-graphic-1024x500.png", optimize=True)
+
+
+if __name__ == "__main__":
+ main()
diff --git a/store/google-play.md b/store/google-play.md
new file mode 100644
index 000000000..5a178768e
--- /dev/null
+++ b/store/google-play.md
@@ -0,0 +1,38 @@
+# Google Play runbook
+
+Status: listing prepared; no Play Console app exists yet.
+
+Package name: `sh.voicestudio.mobile`
+
+Everything the Play Console asks for is in [`google-play/listing.json`](google-play/listing.json),
+so the answers stay reviewable in Git. Graphics are rendered from the app's own
+brand sources by `uv run python scripts/create_google_play_assets.py`.
+`tests/test_google_play_listing.py` checks Play's length and size limits and that
+every permission in the Android manifest has a declaration here.
+
+## Owner steps
+
+1. Register a Play developer account as an **organization** (Yupcha Softwares
+ Private Limited; needs a D-U-N-S number). New personal accounts must run a
+ closed test with 12 testers for 14 days before production.
+2. Create the app with the package name above, keep Play App Signing on, and set
+ the contact email.
+3. **Main store listing:** title, short and full description (join the
+ `fullDescription` lines with newlines), icon, feature graphic, category and
+ 2–8 phone screenshots.
+4. **App content:** privacy policy URL, ads (none), app access (no login), target
+ audience, content rating questionnaire and the data safety form from
+ `dataSafety` (no data collected or shared).
+5. **Permissions and foreground services:** use the reasons in `permissions`.
+ Play asks for a short video of each foreground service type in use.
+6. Upload the first bundle by hand, then use the `Android Play internal testing`
+ workflow ([`docs/mobile.md`](../docs/mobile.md#play-internal-testing-maintainers)).
+
+## Before production
+
+- **AI-generated content:** Play requires an in-app way to report or flag
+ offensive generated content. The app does not have one yet; it ships on both
+ phone apps or neither (`mobile/contract/SPEC.md`).
+- **Privacy policy:** `https://voicestudio.sh/privacy` should describe the phone
+ apps (what leaves the phone: model downloads and requests to the paired computer).
+- **Screenshots:** capture from a release build on a phone or emulator.
diff --git a/store/google-play/feature-graphic-1024x500.png b/store/google-play/feature-graphic-1024x500.png
new file mode 100644
index 000000000..7172119a8
Binary files /dev/null and b/store/google-play/feature-graphic-1024x500.png differ
diff --git a/store/google-play/icon-512.png b/store/google-play/icon-512.png
new file mode 100644
index 000000000..332437b29
Binary files /dev/null and b/store/google-play/icon-512.png differ
diff --git a/store/google-play/listing.json b/store/google-play/listing.json
new file mode 100644
index 000000000..5b2454dca
--- /dev/null
+++ b/store/google-play/listing.json
@@ -0,0 +1,89 @@
+{
+ "schemaVersion": 1,
+ "packageName": "sh.voicestudio.mobile",
+ "defaultLanguage": "en-US",
+ "listing": {
+ "title": "VoiceStudio: Offline Voice AI",
+ "shortDescription": "Clone voices, dictate and dub videos on your phone. Offline, with no account.",
+ "fullDescription": [
+ "VoiceStudio runs speech models on your phone. Once a model is downloaded, it works offline: no account, no API key, and nothing you record or type leaves the device.",
+ "",
+ "WHAT YOU CAN DO",
+ "• Speak: turn text into natural speech with a preset voice or one you cloned.",
+ "• Clone a voice from a short recording or audio file, after confirming you have the speaker's consent.",
+ "• Dictate: live speech-to-text you can copy or share.",
+ "• Dub: transcribe a video, translate it into another language and voice it, then save or share the result.",
+ "",
+ "MODELS YOU CHOOSE",
+ "Pick which models to download. Each shows its size, languages and licence before you download it; models with restrictive licences ask you to accept their terms first. Downloads use Wi-Fi unless you allow mobile data, are checked before use, and can be deleted any time.",
+ "",
+ "LANGUAGES",
+ "Dictation, voice cloning and dubbing cover 11 languages: English, Chinese, Japanese, Korean, French, German, Spanish, Portuguese, Italian, Russian and Arabic. Preset voices are English and Chinese.",
+ "",
+ "USE YOUR COMPUTER TOO (OPTIONAL)",
+ "If you run VoiceStudio on your computer, scan its QR code to pair. Heavy jobs can then run on your computer's engines, chosen per task. The phone talks only to your own computer; there is no cloud relay.",
+ "",
+ "PRIVACY",
+ "On-device tasks send nothing anywhere. The only network requests are model downloads you start and, if you pair, requests to your own computer. Analytics are off unless you say yes, and this version sends none.",
+ "",
+ "OPEN SOURCE",
+ "VoiceStudio is free and open source (AGPL-3.0): https://github.com/debpalash/VoiceStudio",
+ "",
+ "Use voice cloning responsibly: only clone voices you have permission to use."
+ ]
+ },
+ "category": "Music & Audio",
+ "tags": ["Text to speech", "Speech to text", "Voice recorder", "Translation"],
+ "contact": {
+ "website": "https://voicestudio.sh",
+ "email": "Set in Play Console by the account owner",
+ "privacyPolicy": "https://voicestudio.sh/privacy"
+ },
+ "graphics": {
+ "icon": "store/google-play/icon-512.png",
+ "featureGraphic": "store/google-play/feature-graphic-1024x500.png",
+ "phoneScreenshots": "Capture 2 to 8 from a release build (Home, Speak, Voices, Dub, Dictate, Models); 9:16, 1080x1920 or larger"
+ },
+ "dataSafety": {
+ "collectsData": false,
+ "sharesData": false,
+ "rationale": "Models run on the device. Model downloads are user-started requests to Hugging Face, and pairing sends requests only to the user's own computer; neither reaches the developer. The first-run analytics choice is stored on the device and this version transmits no analytics.",
+ "reviewWhen": "Re-answer before shipping phone analytics or any new network destination (mobile/contract/SPEC.md → Privacy)."
+ },
+ "permissions": {
+ "android.permission.INTERNET": "Download the models the user picks and talk to the user's own paired computer.",
+ "android.permission.ACCESS_NETWORK_STATE": "Keep model downloads on Wi-Fi unless the user allows mobile data.",
+ "android.permission.CAMERA": "Scan the pairing QR code shown by VoiceStudio on the user's computer.",
+ "android.permission.RECORD_AUDIO": "Dictation and recording a reference clip for voice cloning, only while the user records.",
+ "android.permission.POST_NOTIFICATIONS": "Tell the user when a dubbing job finishes.",
+ "android.permission.FOREGROUND_SERVICE": "Keep a long dubbing job running with a visible progress notification.",
+ "android.permission.FOREGROUND_SERVICE_DATA_SYNC": "Upload a video to the user's own computer for dubbing and download the result, started by the user."
+ },
+ "appContent": {
+ "ads": false,
+ "appAccess": "All features work without login; no test account needed.",
+ "targetAudience": "18 and over (voice cloning)",
+ "contentRating": {
+ "category": "Utility, productivity, communication, or other",
+ "violence": false,
+ "sexualContent": false,
+ "profanity": false,
+ "controlledSubstances": false,
+ "gambling": false,
+ "userInteraction": false,
+ "sharesLocation": false,
+ "digitalPurchases": false,
+ "note": "Users don't interact with each other; generated audio stays on the device unless the user shares it."
+ },
+ "generativeAi": {
+ "generatesContent": true,
+ "kinds": ["Synthetic speech", "Voice clones", "Translated dubbing"],
+ "consentBeforeCloning": true,
+ "inAppReporting": "Required by Play's AI-generated content policy; not in the app yet (see store/google-play.md)."
+ },
+ "newsApp": false,
+ "healthApp": false,
+ "financialFeatures": false,
+ "governmentApp": false
+ }
+}
diff --git a/tests/test_google_play_listing.py b/tests/test_google_play_listing.py
new file mode 100644
index 000000000..81199281a
--- /dev/null
+++ b/tests/test_google_play_listing.py
@@ -0,0 +1,47 @@
+"""The Google Play listing stays within Play's limits and matches the Android app."""
+
+import json
+import re
+from pathlib import Path
+
+from PIL import Image
+
+ROOT = Path(__file__).resolve().parents[1]
+LISTING = json.loads((ROOT / "store/google-play/listing.json").read_text())
+
+
+def test_text_fits_play_limits():
+ text = LISTING["listing"]
+ assert 0 < len(text["title"]) <= 30
+ assert 0 < len(text["shortDescription"]) <= 80
+ assert 0 < len("\n".join(text["fullDescription"])) <= 4000
+
+
+def test_package_name_matches_the_app():
+ gradle = (ROOT / "mobile/android/app/build.gradle.kts").read_text()
+ assert f'applicationId = "{LISTING["packageName"]}"' in gradle
+
+
+def test_every_manifest_permission_is_declared():
+ # A new permission needs its Play Console reason written before it ships.
+ manifest = (ROOT / "mobile/android/app/src/main/AndroidManifest.xml").read_text()
+ used = set(re.findall(r'uses-permission android:name="([^"]+)"', manifest))
+ assert used == set(LISTING["permissions"])
+
+
+def test_graphics_meet_play_specs():
+ icon = Image.open(ROOT / LISTING["graphics"]["icon"])
+ assert icon.format == "PNG" and icon.size == (512, 512)
+ feature = Image.open(ROOT / LISTING["graphics"]["featureGraphic"])
+ # Play rejects a feature graphic with transparency.
+ assert feature.format == "PNG" and feature.size == (1024, 500) and feature.mode == "RGB"
+ for path in (LISTING["graphics"]["icon"], LISTING["graphics"]["featureGraphic"]):
+ assert (ROOT / path).stat().st_size <= 1024 * 1024
+
+
+def test_store_languages_match_the_phone_models():
+ # The listing names the languages phone cloning supports; keep them in step.
+ models = json.loads((ROOT / "mobile/contract/models.json").read_text())["models"]
+ clone = next(m for m in models if m["capability"] == "clone")
+ description = "\n".join(LISTING["listing"]["fullDescription"])
+ assert f"cover {len(clone['languages'])} languages" in description