Source code and build system for all Torikomi extension APKs.
This repository is the build source. Compiled APKs and catalog entries are stored in [`torikomi-extensions`](https://github.com/univzy/torikomi-extensions).
Each extension is a minimal Android app module that implements the `IExtension` interface and exposes scraping logic via `ContentProvider` IPC.
Each extension is a minimal Android app module (~1–2 MB) that exposes scraping logic via ContentProvider IPC.
Torikomi App ──► content://torikomi.extension.<id>/scrape?url=...&cfCookies=...
│
ExtensionProvider
│
<Platform>Extension.kt
│
JSON payload (ScrapeResult)
│
◄──────────── Torikomi App
Workflow:
- App discovers installed extensions via
AndroidManifest.xmlmetadata. - App invokes the extension's
ContentProviderwith URL + optional CF cookies. - Extension scraper returns a JSON payload.
- App parses the payload into download options and renders them in the UI template.
| Module ID | Platform | Package | Downloader | APK |
|---|---|---|---|---|
musicaldown |
TikTok | com.torikomi.extension_musicaldown |
MusicalDown | torikomi-multi.musicaldown-v1.0.0.apk |
douyin |
Douyin | com.torikomi.extension_douyin |
Douyin | torikomi-multi.douyin-v1.0.0.apk |
snapsave_twitter |
Twitter/X | com.torikomi.extension_snapsave_twitter |
SnapSave | torikomi-multi.snapsave_twitter-v1.0.0.apk |
snapsave_instagram |
com.torikomi.extension_snapsave_instagram |
SnapSave | torikomi-multi.snapsave_instagram-v1.0.0.apk |
|
snapsave_threads |
Threads | com.torikomi.extension_snapsave_threads |
SnapSave | torikomi-multi.snapsave_threads-v1.0.0.apk |
snapsave_facebook |
com.torikomi.extension_snapsave_facebook |
SnapSave | torikomi-multi.snapsave_facebook-v1.0.0.apk |
|
ytdown |
YouTube | com.torikomi.extension_ytdown |
YTDown | torikomi-multi.ytdown-v1.0.0.apk |
spotmate |
Spotify | com.torikomi.extension_spotmate |
Spotmate Downloader | torikomi-multi.spotmate-v1.0.0.apk |
whatsapp_status |
com.torikomi.extension_whatsapp_status |
Use WhatsApp Directly | torikomi-multi.whatsapp_status-v1.0.0.apk |
|
bskysaver |
Bluesky | com.torikomi.extension_bskysaver |
BskySaver | torikomi-multi.bskysaver-v1.0.0.apk |
torikomi-source/
├── build_all.ps1 # Build + copy all extensions to the catalog
├── settings.gradle.kts # Multi-module project definition
├── common/
│ └── kotlin/com/torikomi/
│ ├── extension/
│ │ └── IExtension.kt # Shared scraper interface
│ └── browser/
│ └── BrowserCompatibilityManager.kt # OkHttp TLS helper
└── extensions/
├── musicaldown/
├── douyin/
├── snapsave_twitter/
├── snapsave_instagram/
├── snapsave_threads/
├── snapsave_facebook/
├── ytdown/
├── spotmate/
├── whatsapp_status/
└── bskysaver/
Each extension module follows this layout:
extensions/<id>/
├── proguard-rules.pro
├── src/main/kotlin/com/torikomi/extension_<id>/
│ └── <Platform>Extension.kt # Core scraping logic
└── android/
├── build.gradle.kts
├── settings.gradle.kts
└── app/
├── build.gradle
└── src/main/
├── AndroidManifest.xml
├── res/drawable/icon_<id>.png
└── kotlin/com/torikomi/extension_<id>/
├── ExtensionProvider.kt # ContentProvider IPC entry point
└── MainActivity.kt # Empty activity (required by Flutter engine)
All extensions implement the IExtension interface:
interface IExtension {
fun getId(): String // Unique extension ID, e.g. "spotmate"
fun getPlatformId(): String // Platform ID, e.g. "spotify"
fun getPlatformName(): String // Platform display name, e.g. "Spotify"
fun getVersion(): String // Semver version
fun getDownloaderName(): String // Downloader name
fun getDownloaderDescription(): String
fun canHandle(url: String): Boolean
fun scrape(context: Context, url: String, cfCookies: String? = null): String
}The scrape() function returns a JSON string with the following structure:
{
"extensionId": "spotmate",
"platform": "spotify",
"platformName": "Spotify",
"title": "TWICE - SIGNAL",
"author": "TWICE",
"authorName": "TWICE",
"duration": 196,
"thumbnail": "https://i.scdn.co/image/...",
"downloadItems": [
{
"key": "audio_mp3",
"label": "Audio MP3",
"type": "audio",
"url": "https://...",
"mimeType": "audio/mpeg",
"quality": "MP3"
}
],
"images": []
}For playlists/albums, item type is "playlist_item" and url contains an individual track link.
Each AndroidManifest.xml declares the following metadata:
| Key | Example Value |
|---|---|
torikomi.extension |
true |
torikomi.extension.id |
spotmate |
torikomi.extension.platform |
spotify |
torikomi.extension.platformName |
Spotify |
torikomi.extension.version |
1.0.0 |
torikomi.extension.downloader |
Spotmate Downloader |
torikomi.extension.description |
Download Spotify tracks... |
torikomi.extension.urlPlaceholder |
https://open.spotify.com/track/... |
torikomi.extension.lang |
multi |
torikomi.extension.icon |
spotmate |
torikomi.extension.color |
#1DB954 |
flutterEmbedding |
2 |
- Android SDK (compileSdk 34, minSdk 23)
- JDK 11+
- Gradle wrapper (
gradlew/gradlew.bat) — available in each extension'sandroid/folder ANDROID_SDK_ROOTorANDROID_HOMEenvironment variable, or alocal.propertiesfile withsdk.dir=<path>
.\build_all.ps1 -CatalogPath "..\torikomi-extensions"APKs are compiled and automatically copied to torikomi-extensions/apk/.
.\build_all.ps1 -Extensions "spotmate" -CatalogPath "..\torikomi-extensions".\gradlew.bat :extensions:spotmate:assembleRelease
.\gradlew.bat :extensions:musicaldown:assembleRelease
.\gradlew.bat :extensions:douyin:assembleRelease
.\gradlew.bat :extensions:ytdown:assembleRelease- Copy an existing module as a template:
Copy-Item -Recurse extensions\musicaldown extensions\new_ext
- Update
extensions\new_ext\android\app\build.gradle:namespace,applicationId→com.torikomi.extension_new_ext
- Update
AndroidManifest.xml:android:authorities→torikomi.extension.new_ext- All
meta-datavalues (id,platform,platformName,downloader,color, etc.) - Replace
android:iconwith the new icon
- Rename the class in
ExtensionProvider.ktand create<Platform>Extension.ktinsrc/main/kotlin/. - Add the icon to
android/app/src/main/res/drawable/icon_new_ext.png. - Register in
settings.gradle.kts:val extensionIds = listOf( // ... existing extensions "new_ext" )
- Register in the
$AllExtensionsarray inbuild_all.ps1:@{ id = "new_ext"; lang = "multi"; version = "1.0.0" }
- Build:
.\build_all.ps1 -Extensions "new_ext" -CatalogPath "..\torikomi-extensions" - Add a new entry to
torikomi-extensions/index.jsonand regenerateindex.min.json.
Some extensions (musicaldown, spotmate) require a cf_clearance cookie to bypass Cloudflare. This cookie is passed by the main app as the cfCookies parameter to the ContentProvider:
content://torikomi.extension.spotmate/scrape?url=...&cfCookies=cf_clearance%3D...
The extension is responsible for including it when making HTTP requests to the target site.
