HideMyAndroid Headless API

Persyaratan

Headless API memungkinkan Anda mengontrol HideMyAndroid sepenuhnya melalui ADB atau alat otomasi apa pun — tanpa memerlukan UI aplikasi. Ini adalah fitur Premium.

• Akun Premium — Headless API hanya tersedia untuk pengguna Premium.
• Versi aplikasi 1.2.8 atau lebih baru. Semua yang ditambahkan sejak itu berupa kolom atau metode tambahan, jadi 1.2.8 tetap berfungsi — tetapi bagian yang lebih baru memerlukan build yang lebih baru: hook_spoof_uptime memerlukan 1.3.4+, geo dan profile.duplicate memerlukan 1.4.5+, seluruh grup pencadangan / pemulihan memerlukan 1.5.3+, generator SIM & perangkat (simCountries, deviceTemplate, sim.countries, device.templates) memerlukan 1.5.9+, hook_sensor_gyroscope memerlukan 1.6.3+, dan hook_sensor_light memerlukan 1.6.4+. Build lama mengabaikan kolom yang tidak dikenalnya dan tetap menjawab ok=true — tetapi metode yang tidak dikenal lebih nyaring: memanggil grup pencadangan / pemulihan pada build sebelum 1.5.3, atau sim.countries / device.templates sebelum 1.5.9, mengembalikan BAD_REQUEST dengan error_message “Unknown method: …”. Bila sebuah pengaturan tampak tidak berpengaruh, periksa version yang sedang berjalan lewat status — rilis terpaket melaporkannya dengan akurat, sedangkan build hasil kompilasi sendiri yang dibuat sebelum nomor versinya dinaikkan bisa saja sudah membawa sebuah fitur namun tetap melaporkan nomor yang lama.
• Root + LSPosed — konfigurasi yang sama yang dibutuhkan HideMyAndroid. Lihat panduan instalasi.
• ADB yang terhubung ke perangkat Anda (adb devices akan menampilkannya).
• Internet pada perangkat — hanya diperlukan saat Anda mengaktifkan proxy (diuji secara langsung).

⚠️ Izin VPN hanya diperlukan untuk profil yang memakai proxy. Mode headless tidak dapat memunculkan dialog persetujuan VPN sistem, jadi berikan izinnya sekali dari layar Headless API di aplikasi. Tanpa itu, mengaktifkan profil berproxy tetap mengaktifkan profilnya, tetapi proxy tidak akan terhubung dan panggilan mengembalikan INTERNAL yang menyatakan hal tersebut.

Autentikasi

Buka Pengaturan → Developer → Headless API di aplikasi dan aktifkan Enable. Kunci akan dibuat secara otomatis — ketuk Copy. Setiap permintaan mengirimkan kunci ini sebagai parameter token.

Jaga kerahasiaannya — siapa pun yang memiliki kunci dan akses ADB dapat mengontrol profil Anda. Regenerate akan menerbitkan kunci baru (kunci lama tidak akan berfungsi lagi); keluar dari aplikasi akan menghapusnya.

Sepanjang referensi ini, ganti <your_access_token> dengan kunci Anda dan <profile_id> dengan id yang dikembalikan oleh profile.create.

Membuat permintaan

Dua transport, dipilih berdasarkan apakah nilai mengandung tanda titik dua :

content call memisahkan setiap --extra pada tanda titik dua, sehingga tidak dapat membawa JSON — itulah mengapa nilai JSON dikirim melalui broadcast.

Hanya tiga metode yang punya bentuk broadcast: HEADLESS_UPDATE (profile.update), HEADLESS_SET_ACTIVE, dan HEADLESS_DEACTIVATE. Tujuh belas sisanya — status, semua operasi baca (termasuk sim.countries dan device.templates), profile.create, profile.duplicate, profile.delete, panggilan aplikasi target, dan seluruh grup pencadangan / pemulihan — hanya lewat content call. Tidak ada HEADLESS_CREATE — atau HEADLESS_BACKUP — yang perlu dicari.

Broadcast bukan hanya untuk JSON. HEADLESS_UPDATE meneruskan tepat sembilan extra — name, hookFlags, proxy, geo, deviceMock, sim, gmails, dan sejak 1.5.9 simCountries serta deviceTemplate — sehingga name, gmails, dan simCountries bisa lewat kedua transport. Tabel di atas soal mana yang lebih praktis, bukan mana yang mungkin. Extra apa pun yang namanya tidak termasuk dalam sembilan itu akan dibuang tanpa kesalahan.

Respons. Sukses ditandai dengan ok=true (content call) atau result=0 (broadcast); kegagalan menambahkan error_code dan error_message. Lihat Kode error. Setiap metode juga menerima token. Klik operasi mana pun di bawah untuk memperluas parameter, permintaan, dan responnya.

Status

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method status --extra token:s:<your_access_token>

Bundle[{data={"premium":true,"featureEnabled":true,"freshnessOk":true,"activeProfileId":"a1b2c3d4-...","version":"1.5.9"}, ok=true}]

💡 status adalah satu-satunya metode yang tetap menjawab saat lisensi kedaluwarsa atau basi — semua panggilan lain hanya mengembalikan LICENSE_EXPIRED atau LICENSE_STALE. Itulah cara membedakan keduanya ketika permintaan ditolak: baca premium untuk melihat apakah Premium benar-benar habis, dan freshnessOk untuk melihat apakah aplikasi sekadar perlu dibuka sekali. status tetap dibatasi oleh FEATURE_DISABLED dan UNAUTHORIZED, jadi API yang mati atau token yang salah tampak sama seperti di tempat lain.

Profil

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.list --extra token:s:<your_access_token>

Bundle[{data=[{"id":"a1b2...","name":"Demo","isActive":true,"createdAt":1717000000000,"updatedAt":1717000500000}], ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.get --extra token:s:<your_access_token> --extra id:s:<profile_id>

Bundle[{data={"id":"a1b2...","name":"Demo","isActive":false,"hookFlags":{"hook_wifi":true,...},"proxy":{"enabled":false,...},"geo":{"source":"PROXY",...},"deviceMock":{"enabled":false,...},"sim":{"enabled":false,"simCards":[]},"gmails":[],"targetApps":["com.whatsapp"]}, ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.create --extra token:s:<your_access_token> --extra name:s:Demo

Bundle[{data={"id":"a1b2c3d4-..."}, ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.duplicate --extra token:s:<your_access_token> --extra id:s:<profile_id>

Bundle[{data={"id":"e5f6a7b8-...","name":"Brave Falcon 42"}, ok=true}]

Apa saja yang ikut ke salinan

Mengklon profil persis seperti menu Duplicate di dalam aplikasi — memerlukan aplikasi 1.4.5+. Pengaturan ikut terbawa, tetapi setiap nilai penanda identitas dibuat ulang, sehingga salinannya punya sidik jari sendiri alih-alih menjadi kembaran aslinya. Tidak ada bentuk broadcast: broadcast sekali-kirim-lalu-lupakan tidak dapat menyerahkan id baru kepada Anda, padahal itulah inti panggilan ini.

Untuk mendapatkan nama Anda sendiri, duplikasi dahulu lalu ganti namanya pada panggilan kedua:

# 1. duplicate — the new id and its generated name come back together
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.duplicate --extra token:s:<your_access_token> --extra id:s:<source_profile_id>

# 2. rename the copy — profile.duplicate never takes a name of your own
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<new_profile_id> --extra name:s:"My Profile"

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra name:s:"My Profile"

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e hookFlags '{"hook_wifi":false,"hook_nearby_bluetooth":false}'

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.delete --extra token:s:<your_access_token> --extra id:s:<profile_id>

Bundle[{data={}, ok=true}]

Aktivasi

Profil hanya melakukan spoofing setelah aktif, dan hanya satu profil yang pernah aktif. profile.setActive mengalihkan profil aktif — profil yang sebelumnya aktif akan dinonaktifkan untuk Anda, jadi tidak perlu memanggil profile.deactivate lebih dulu.

⚠️ Mengaktifkan akan menghapus data aplikasi target. profile.setActive tidak sekadar memulai ulang aplikasi: ia menghentikan paksa setiap aplikasi target dan menghapus datanya, agar aplikasi itu hidup kembali dalam keadaan bersih dan benar-benar memakai identitas baru. Ini memang disengaja — tetapi artinya semua isi aplikasi tersebut hilang, termasuk sesi yang sudah masuk, Di dalam aplikasi, tindakan yang sama meminta konfirmasi terlebih dahulu dan mengarahkan Anda ke fitur Backup; panggilan headless tidak memunculkan dialog apa pun dan langsung dijalankan, jadi peringatan ini adalah satu-satunya yang Anda dapatkan. Secara headless, jaring pengamannya adalah backup.start (1.5.3+) sebelum Anda berpindah. Dan sejak 1.5.3, selama tugas pencadangan / pemulihan masih menahan slotnya, profile.setActive dan profile.deactivate menjawab BUSY — bahkan untuk tugas yang sudah dibatalkan; ulangi sampai BUSY berhenti.

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.setActive --extra token:s:<your_access_token> --extra id:s:<profile_id>

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_SET_ACTIVE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id>

Bundle[{data={"id":"a1b2...","isActive":true}, ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.deactivate --extra token:s:<your_access_token>

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_DEACTIVATE -p com.wowsoftware.hidemyandroid -e token <your_access_token>

Bundle[{data={}, ok=true}]

content call adalah bentuk yang sebaiknya dipilih: ia sinkron dan mencetak Bundle yang dikembalikan. Broadcast HEADLESS_SET_ACTIVE dan HEADLESS_DEACTIVATE melakukan tugas yang sama untuk perkakas otomatisasi seperti Tasker. Keduanya membalas sebagai ordered broadcast, yang selalu membawa data kembali: saat berhasil am broadcast mencetak result=0 dengan JSON hasil di data="…", dan saat gagal result=1 dengan data="{"error_code":…,"error_message":…}". Jadi keduanya tidak benar-benar sekali-kirim-lalu-lupakan — uraikan data= dan Anda memperoleh jawaban yang sama seperti dari content call. HEADLESS_SET_ACTIVE menerima id profil baik sebagai -e id maupun -e profile_id; HEADLESS_DEACTIVATE sama sekali tidak memerlukan id. Seperti biasa, sertakan -p com.wowsoftware.hidemyandroid.

Aplikasi target

Aplikasi target adalah aplikasi yang di-spoof oleh suatu profil.

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.getApps --extra token:s:<your_access_token> --extra id:s:<profile_id>

Bundle[{data=[{"packageName":"com.whatsapp"}], ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.addApp --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.whatsapp

Bundle[{data=[{"packageName":"com.whatsapp"}], ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.removeApp --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.whatsapp

Bundle[{data=[], ok=true}]

Pencadangan & pemulihan

Baru di 1.5.3, grup ini menyalin data aplikasi sebuah profil ke dalam arsip di perangkat dan menuangkannya kembali nanti — tugas yang sama dengan Manage Backups di aplikasi, tanpa UI-nya. Keenam metodenya hanya lewat content call (tidak ada bentuk broadcast), dan kedua panggilan *.start bersifat asinkron: keduanya langsung menyerahkan jobId lalu terus bekerja di latar belakang — pantau backup.job untuk mengikutinya. Mencadangkan satu aplikasi saja bisa memakan waktu bermenit-menit.

⚠️ Satu tugas pada satu waktu. *.start kedua saat satu tugas sedang berjalan mengembalikan BUSY, dengan jobId yang sedang berjalan di error_message. Kedua panggilan *.start juga mengharuskan profil yang dituju berstatus aktif — bila tidak, REQUIRES_ACTIVE_PROFILE, dan tidak ada flag untuk melewatinya. Empat metode lainnya bekerja pada profil mana pun. Dan seperti di seluruh headless API, tidak ada yang meminta konfirmasi — setiap panggilan langsung dijalankan.

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.start --extra token:s:<your_access_token> --extra id:s:<profile_id>

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.start --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packages:s:com.twitter.android,com.facebook.katana

Bundle[{data={"jobId":"f0e1d2c3-...","type":"backup","total":2,"packages":["com.twitter.android","com.facebook.katana"],"foregroundHeld":true}, ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method restore.start --extra token:s:<your_access_token> --extra id:s:<profile_id>

Bundle[{data={"jobId":"09a8b7c6-...","type":"restore","total":1,"packages":["com.twitter.android"],"foregroundHeld":true}, ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.job --extra token:s:<your_access_token> --extra jobId:s:<job_id>

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.job --extra token:s:<your_access_token>

# while it runs
Bundle[{data={"jobId":"f0e1d2c3-...","type":"backup","profileId":"a1b2...","state":"RUNNING","total":2,"done":0,"ok":0,"failed":0,"currentPackage":"com.twitter.android","currentComponent":"Internal Data","progress":0.31,"results":[],"error":null,"foregroundHeld":true,"startedAt":1712345678901,"finishedAt":null}, ok=true}]

# when it finishes — note: DONE even though one app failed
Bundle[{data={"jobId":"f0e1d2c3-...","type":"backup","profileId":"a1b2...","state":"DONE","total":2,"done":2,"ok":1,"failed":1,"currentPackage":null,"currentComponent":null,"progress":1.0,"results":[{"packageName":"com.twitter.android","ok":true,"error":null},{"packageName":"com.facebook.katana","ok":false,"error":"tar exited 2"}],"error":null,"foregroundHeld":true,"startedAt":1712345678901,"finishedAt":1712345699999}, ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.cancel --extra token:s:<your_access_token> --extra jobId:s:<job_id>

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.list --extra token:s:<your_access_token> --extra id:s:<profile_id>

Bundle[{data=[{"packageName":"com.twitter.android","appName":"X","timestamp":1712345678901,"totalSize":12345678,"components":["INTERNAL_DATA","EXTERNAL_DATA","OBB"]}], ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.delete --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.twitter.android

Bundle[{data={}, ok=true}]

Bagaimana tugas berperilaku

• DONE tidak berarti setiap aplikasi berhasil. Ia hanya berarti tugas berjalan sampai akhir. Sebuah aplikasi bisa gagal sementara tugasnya tetap selesai DONE — selalu baca failed dan results[].
• Aktivasi kini menunggu tugas. Selama sebuah tugas menahan slotnya, profile.setActive, profile.deactivate, dan profile.delete menjawab BUSY — bahkan untuk tugas yang sudah Anda batalkan, karena tar root di baliknya tidak dapat dihentikan di tengah file, dan tidak ada kolom potret yang melaporkan slot itu. Tugas yang berakhir wajar di DONE atau FAILED membebaskan slotnya hampir seketika; setelah pembatalan, jangan anggap CANCELLED sebagai “slot bebas” — cukup ulangi panggilannya sampai BUSY berhenti.
• foregroundHeld adalah pengamatan, bukan janji. Ia melaporkan apakah sebuah foreground service sedang melindungi tugas agar tidak dimatikan oleh OS. Nilainya terukur true pada API 36, tetapi bahkan true hanya berarti permintaan memulai service diterima — langkah promosi berikutnya masih bisa gagal diam-diam di sebagian perangkat. Untuk tugas yang panjang, jaga perangkat tetap terjaga alih-alih bergantung padanya.
• Tempat cadangan disimpan. /sdcard/HideMyAndroid_Backups/<packageName>-<profileId>/ — satu folder per aplikasi per profil, berisi arsip .tar.gz (data.tar.gz, data_ext.tar.gz, media.tar.gz, …) ditambah metadata.json, ditulis dengan tar root. Kunci {package}-{profileId} itulah yang membuat pemulihan hanya bisa ke profil yang sama. Cadangan yang dibuat secara headless juga muncul di layar Manage Backups aplikasi.

SIM & perangkat dari basis data bawaan

Baru di 1.5.9. Konfigurasi di bawah menunjukkan cara menulis blok sim atau deviceMock secara manual, kolom demi kolom. Grup ini memungkinkan Anda melewatinya: dua kunci profile.update tambahan — simCountries dan deviceTemplate — membuat aplikasi menghasilkan seluruh blok dari basis data operator dan perangkat yang sama dengan yang dipakai UI-nya sendiri, dan dua metode baca menampilkan daftar apa saja yang bisa dihasilkannya. Hasilnya disimpan ke dalam profil dengan enabled:true yang sudah ditetapkan, jadi tidak ada lagi yang perlu dikirim — baca kembali dengan profile.get.

⚠️ Satu cara per pengaturan, per panggilan. sim dan simCountries dalam permintaan yang sama adalah BAD_REQUEST, begitu pula deviceMock bersama deviceTemplate. Mencampur antar pengaturan tidak masalah — simCountries berdampingan dengan deviceMock yang ditulis manual, atau kedua generator sekaligus, seperti pada contoh pertama di bawah. Panggilannya atomik: semuanya divalidasi sebelum ada yang disimpan, jadi id templat yang salah menggagalkan seluruh permintaan dan simCountries yang dikirim bersamanya pun tidak diterapkan.

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method sim.countries --extra token:s:<your_access_token>

Bundle[{data=[{"code":"AF","country":"Afghanistan"},{"code":"AL","country":"Albania"},...,{"code":"GB","country":"United Kingdom"},...,{"code":"US","country":"United States"},...], ok=true}]

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method device.templates --extra token:s:<your_access_token>

Bundle[{data=[{"id":"asus|ASUS_AI2401|AI2401_A","manufacturer":"asus","label":"ROG Phone 8","isCustom":false},...,{"id":"custom:samsung|e3qxeea|SM-S928B","manufacturer":"samsung","label":"Galaxy S24 Ultra","isCustom":true}], ok=true}]

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e simCountries '["US","GB"]' -e deviceTemplate random

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'simCountries:s:["US"]'

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra deviceTemplate:s:random

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'deviceTemplate:s:asus|ASUS_AI2401|AI2401_A'

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e deviceTemplate 'custom:samsung|e3qxeea|SM-S928B'

simCountries

• Format. Larik JSON berisi kode ISO 3166-1 alpha-2 — ["US","GB"], tidak membedakan huruf besar/kecil. Posisi menentukan slot: kode pertama mengisi slot 0, kode kedua slot 1. Apa pun yang bukan larik JSON, larik kosong, entri kosong, lebih dari dua entri, atau kode yang tidak tercantum di sim.countries mengembalikan BAD_REQUEST — kode ketiga ditolak, tidak pernah dibuang diam-diam seperti kartu sim ketiga.
• Yang Anda dapatkan. Untuk setiap slot, aplikasi memilih satu operator dari negara tersebut dari basis datanya dan mengisi setiap kolom blok sim yang biasa ditulis manual: carrierName, countryIso, mcc, mnc, operatorCode, phoneNumber seluler E.164 yang valid dengan kode telepon negaranya (+1… untuk US), iccid dan imsi yang berawalan MCC+MNC operator itu, serta networkType yang diundi acak dari LTE, NR 5G, WCDMA, dan GSM. Lalu ia menetapkan sim.enabled ke true dan menyimpannya.
• Ia menggantikan seluruh blok SIM. Seperti halnya sim, hasilnya dinormalkan menjadi dua kartu: ["US"] mengisi slot 0 dan membiarkan slot 1 kosong, apa pun isinya sebelumnya.

deviceTemplate

• random (atau string kosong) — aplikasi mengundi satu templat dari semua yang dikenalnya, bawaan maupun hasil impor. Perhatikan perbedaan antara kosong dan tidak ada: -e deviceTemplate "" berarti acak, sedangkan tidak menyertakan kuncinya sama sekali membiarkan perangkat tidak tersentuh.
• Id templat dari device.templates — perangkat itu, setiap kali. Id bawaan berbentuk brand|product|model, mis. asus|ASUS_AI2401|AI2401_A; templat yang Anda impor di aplikasi memakai bentuk yang sama dengan awalan custom:, mis. custom:samsung|e3qxeea|SM-S928B. Id yang tidak ada dalam daftar mengembalikan BAD_REQUEST.
• Yang Anda dapatkan. Setiap kolom deviceMock terisi dari templat, deviceMock.enabled ditetapkan ke true, dan profil disimpan.

Transport yang mana

Aturan titik dua yang biasa tetap berlaku. sim.countries, device.templates, simCountries, dan id templat bawaan tidak mengandung :, sehingga content call dapat membawanya. Apit nilainya dengan tanda kutip tunggal setiap kali mengandung |, [, ], atau " — yaitu setiap larik simCountries dan setiap id templat. Tanpa tanda kutip, shell perangkat membaca | sebagai pipe dan gagal bahkan sebelum content dijalankan (sh: e3qxeea: not found, exit 127). Id kustom diawali custom:, dan titik dua tambahan itu merusak bentuk key:type:value dari --extra: alat content sendiri menolaknya dengan [ERROR] Binding not well formed dan permintaan tidak pernah sampai ke aplikasi — tidak ada BAD_REQUEST yang bisa ditangkap. Kirim id kustom lewat broadcast HEADLESS_UPDATE; tidak ada hal lain yang berubah pada panggilannya.

Konfigurasi

Ini adalah nilai yang Anda kirim dengan profile.update. Default saat profil dibuat:

⚠️ Konfigurasi dengan enabled:false disimpan tetapi tidak aktif — nilai disimpan agar Anda dapat mengaktifkannya nanti, tetapi tidak ada spoofing hingga enabled:true. geo adalah pengecualian: ia tidak punya sakelar enabled. Flag hook_geo_* berlaku setiap kali geo menghasilkan lokasi yang dapat dipakai — baik dari source: CUSTOM, maupun dari proxy yang enabled:true dan lulus uji langsungnya.

hookFlags

Default: ON untuk setiap flag kecuali hook_spoof_uptime, yang OFF. Peta berisi "flag": true|false. Pembaruan menggantikan seluruh peta, tetapi hanya peta yang benar-benar Anda kirim: pembaruan yang sama sekali tidak menyertakan extra hookFlags membiarkan semua flag apa adanya. Di dalam peta yang Anda kirim, setiap flag yang Anda hilangkan kembali ke nilai defaultnya masing-masing, sehingga 22 flag lainnya kembali ON sementara hook_spoof_uptime kembali OFF meski sebelumnya Anda aktifkan. Untuk mengubah beberapa flag dan mempertahankan yang lain, jalankan profile.get terlebih dahulu, edit peta lengkap, lalu kirim semuanya kembali.

proxy

Default: OFF. Dengan enabled:true, aplikasi terhubung melaluinya secara nyata, membaca lokasinya, dan mengisi countryCode/lat/lon/timezone. Uji langsung memakan waktu hingga ~8 detik; proxy yang gagal mengembalikan PROXY_INVALID dan tidak disimpan. Keempat kolom itu adalah keluaran — aplikasi yang menulisnya, jadi apa pun yang Anda kirim di sana akan ditimpa. Untuk menetapkan lokasi secara manual, gunakan geo dengan source: CUSTOM; cara itu tidak memerlukan proxy sama sekali. profile.get mengembalikan proxy beserta keempat kolom tersebut, tetapi tidak pernah menampilkan username atau password.

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e proxy '{"enabled":true,"host":"10.0.0.1","port":1080,"protocol":"SOCKS5"}'

geo

Default: {"source":"PROXY"}. Memerlukan aplikasi 1.4.5+. Di sinilah lokasi sebuah profil berasal, dan ada dua sumber — pilih salah satu lewat source. PROXY memakai lokasi yang dibaca saat uji langsung proxy. CUSTOM membiarkan Anda menetapkan sendiri koordinat, zona waktu, dan wilayah, tanpa proxy sama sekali — jadi Anda bisa menempatkan profil di Tokyo sementara trafik dialirkan ke mana pun, atau tidak ke mana-mana. Ketiga flag hook_geo_* lalu mengaktifkan tiap bagian secara terpisah: GPS, wilayah + bahasa, dan zona waktu.

⚠️ Perhatikan nama kolomnya: geo menulisnya latitude/longitude, sedangkan proxy di atas memakai singkatan lat/lon. Keduanya objek yang berbeda, bukan alias — nama singkat di dalam payload geo hanya akan diabaikan.

⚠️ source: CUSTOM harus lengkap: sepasang koordinat yang bukan 0/0 dan berada dalam rentang, countryCode dua huruf, serta timezone. Kurang satu saja, panggilan mengembalikan BAD_REQUEST — ia tidak jatuh kembali ke proxy. Aplikasi tidak pernah melakukan geocoding dan tidak pernah daring untuk mengisikannya bagi Anda. Jika tidak ada satu pun sumber yang dapat dipakai, tidak ada hook geo yang dimuat sama sekali dan lokasi asli akan terlihat.

🛑 timezone adalah satu-satunya kolom yang sebenarnya tidak diperiksa. Ia hanya diuji agar tidak kosong — tidak pernah dicocokkan dengan basis data IANA. Salah ketik seperti Asia/Tokyoo akan diterima, mengembalikan ok=true, dikembalikan apa adanya oleh profile.get, lalu diam-diam berubah menjadi GMT di perangkat. Tidak ada satu pun titik yang melaporkan kesalahan, jadi salin namanya persis. Koordinat justru sebaliknya — nilainya benar-benar diperiksa rentangnya dan yang keliru gagal dengan jelas lewat BAD_REQUEST.

CUSTOM — tetapkan lokasi secara manual, tanpa perlu proxy

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e geo '{"source":"CUSTOM","latitude":35.6812,"longitude":139.7671,"countryCode":"JP","timezone":"Asia/Tokyo","language":"ja"}'

PROXY — ambil lokasi dari proxy (default)

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e geo '{"source":"PROXY"}'

deviceMock

Default: OFF. Berpura-pura perangkat adalah model yang berbeda. Atur "enabled":true beserta salah satu kolom berikut — semua string opsional (default kosong), masing-masing memetakan ke properti Build Android. Pada 1.5.9+ Anda dapat melewati blok ini sepenuhnya dan mengirim deviceTemplate sebagai gantinya — random mengundi satu perangkat dari basis data aplikasi sendiri, sedangkan id dari device.templates memilih perangkat tertentu — dan aplikasi mengisi setiap kolom serta mengaktifkannya untuk Anda.

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e deviceMock '{"enabled":true,"manufacturer":"Samsung","brand":"samsung","model":"SM-S918B","device":"dm3q","product":"dm3qxxx","board":"kalama","hardware":"qcom","buildId":"UP1A.231005.007","buildIncremental":"S918BXXU3CWK9","buildType":"user","buildTags":"release-keys","buildFingerprint":"samsung/dm3qxxx/dm3q:14/UP1A.231005.007/S918BXXU3CWK9:user/release-keys","deviceName":"Galaxy S23 Ultra"}'

Atau, pada 1.5.9+, biarkan aplikasi mengundi perangkat acak dari basis datanya — tanpa JSON sama sekali (random mengambil dari templat bawaan maupun hasil impor; ganti dengan id dari device.templates untuk memilih satu perangkat tertentu):

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra deviceTemplate:s:random

sim

Default: OFF. Memalsukan SIM/operator. Atur "enabled":true dan sediakan hingga dua kartu di simCards. Daftarnya selalu dinormalkan menjadi tepat dua: kartu ketiga dibuang diam-diam — panggilan tetap mengembalikan ok=true — dan satu kartu akan dilengkapi kartu kedua yang kosong, itulah sebabnya profile.get selalu mengembalikan dua. Pada 1.5.9+ Anda dapat melewati blok ini sepenuhnya dan mengirim simCountries sebagai gantinya — aplikasi menghasilkan data operator sungguhan untuk setiap slot dan mengaktifkannya untuk Anda. Setiap kartu:

networkType dipangkas spasinya lalu dicocokkan tanpa membedakan huruf besar/kecil, dan tiap generasi jaringan menerima lebih dari satu penulisan:

⚠️ Apa pun di luar tabel ini akan menonaktifkan spoof tipe jaringan untuk kartu tersebut secara diam-diam — tanpa kesalahan, tanpa BAD_REQUEST: nilainya sekadar disimpan dan tidak pernah dipakai. Perhatikan bahwa NR 5G memakai spasi: NR5G tidak dikenali dan jatuh tepat ke lubang senyap itu.

adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e sim '{"enabled":true,"simCards":[{"slotIndex":0,"carrierName":"AT&T","countryIso":"us","mcc":"310","mnc":"410","operatorCode":"310410","networkType":"LTE"},{"slotIndex":1,"carrierName":"T-Mobile","countryIso":"us","mcc":"310","mnc":"260","operatorCode":"310260","networkType":"NR 5G"}]}'

Atau, pada 1.5.9+, biarkan aplikasi membuat kedua kartu dari kode negara — tanpa JSON sama sekali (slot 0 mendapat kode pertama, slot 1 kode kedua; satu kode hanya mengisi slot 0):

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'simCountries:s:["US","GB"]'

gmails

Default: kosong. Daftar akun Google virtual — hanya alamat @gmail.com yang diterima. Daftar baru menggantikan yang sebelumnya; [] menghapusnya. Tidak ada : di dalamnya, sehingga content call dapat digunakan:

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'gmails:s:["[email protected]","[email protected]"]'

Contoh lengkap

Sebuah profil dari nol sampai aktif, selangkah demi selangkah. Langkah 5, 6, dan 7 masing-masing menawarkan beberapa cara menuju hasil yang sama — pilih satu per langkah; tab-nya berpindah di antara cara-cara itu. Setiap perintah ditampilkan dalam bentuk adb shell. Di bagian akhir, dua resep memadatkan seluruh urutan menjadi satu blok salin-dan-jalankan, dan Pemecahan masalah menyajikan hal yang sama sebagai skrip di perangkat.

Sekilas

1. 01 Periksa apakah API siap
2. 02 Buat profil
3. 03 Tambahkan aplikasi target
4. 04 Tambahkan akun Gmail virtual
5. 05 Pilih identitas perangkat
6. 06 Pilih kartu SIM
7. 07 Jaringan dan lokasi
8. 08 Atur flag hook
9. 09 Cadangkan profil yang akan ditinggalkan
10. 10 Aktifkan
11. 11 Verifikasi
12. 12 Nanti: klon, hentikan, hapus

Placeholder yang dipakai di bawah

• <your_access_token> — kunci dari Pengaturan → Developer → Headless API
• <profile_id> — id yang dikembalikan langkah 2
• <active_profile_id> / <job_id> — hanya langkah 9, dari status dan backup.start

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method status --extra token:s:<your_access_token>
# expect  "premium":true, "featureEnabled":true, "freshnessOk":true
# anything else: fix that first — see Status and Error codes above

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.create --extra token:s:<your_access_token> --extra name:s:Demo
# → Bundle[{data={"id":"a1b2c3d4-..."}, ok=true}]
# copy that id — it is <profile_id> in every command below

# one call per app — the package name, not the display name
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.addApp --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.whatsapp
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.addApp --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.instagram.android

# check the list (adding the same package twice returns BAD_REQUEST)
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.getApps --extra token:s:<your_access_token> --extra id:s:<profile_id>

# @gmail.com only; the list replaces the previous one, [] clears it
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'gmails:s:["[email protected]","[email protected]"]'

# 1.5.9+ — one call, no JSON: the app rolls a device from its database
# (built-in and imported templates alike) and switches deviceMock on for you
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra deviceTemplate:s:random

# 1.5.9+ — first see what is available; "id" is what you send back
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method device.templates --extra token:s:<your_access_token>
# → [{"id":"asus|ASUS_AI2401|AI2401_A","manufacturer":"asus","label":"ROG Phone 8","isCustom":false}, ...]

# built-in id → content call works — single quotes are REQUIRED, | is a shell pipe
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'deviceTemplate:s:asus|ASUS_AI2401|AI2401_A'

# imported (custom:) id → broadcast ONLY; the extra colon breaks content call
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e deviceTemplate 'custom:samsung|e3qxeea|SM-S928B'

# any version — write every Build field yourself; "enabled":true is the switch
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e deviceMock '{"enabled":true,"manufacturer":"Samsung","brand":"samsung","model":"SM-S918B","device":"dm3q","product":"dm3qxxx","board":"kalama","hardware":"qcom","buildId":"UP1A.231005.007","buildIncremental":"S918BXXU3CWK9","buildType":"user","buildTags":"release-keys","buildFingerprint":"samsung/dm3qxxx/dm3q:14/UP1A.231005.007/S918BXXU3CWK9:user/release-keys","deviceName":"Galaxy S23 Ultra"}'

# 1.5.9+ — see which countries the generator knows ("code" is what you send)
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method sim.countries --extra token:s:<your_access_token>
# → [{"code":"AF","country":"Afghanistan"}, ..., {"code":"GB","country":"United Kingdom"}, ..., {"code":"US","country":"United States"}, ...]

# two cards: slot 0 = US, slot 1 = GB — carrier, number, ICCID, IMSI all generated
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'simCountries:s:["US","GB"]'

# or a single card — slot 1 is left empty
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'simCountries:s:["US"]'

# any version — two cards, every field yourself; a third card is dropped silently
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e sim '{"enabled":true,"simCards":[{"slotIndex":0,"carrierName":"AT&T","countryIso":"us","mcc":"310","mnc":"410","operatorCode":"310410","networkType":"LTE","phoneNumber":"+12025550123","iccid":"8901410123456789012","imsi":"310410123456789"},{"slotIndex":1,"carrierName":"T-Mobile","countryIso":"us","mcc":"310","mnc":"260","operatorCode":"310260","networkType":"NR 5G","phoneNumber":"+12025550456","iccid":"8901260987654321098","imsi":"310260987654321"}]}'

# 1.5.9+ — device (step 5) and SIM (step 6) in ONE broadcast: validated together, saved together
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e simCountries '["US","GB"]' -e deviceTemplate random

# the proxy is tested live (device needs internet, up to ~8s);
# one that fails returns PROXY_INVALID and is not saved
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e proxy '{"enabled":true,"host":"10.0.0.1","port":1080,"protocol":"SOCKS5"}'
# with auth: add "username":"…","password":"…" — never echoed back by profile.get

# location follows the proxy by default; this line only matters if geo was CUSTOM before
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e geo '{"source":"PROXY"}'

# no proxy at all — the location is yours; coordinates, countryCode and timezone are all required
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e geo '{"source":"CUSTOM","latitude":35.6812,"longitude":139.7671,"countryCode":"JP","timezone":"Asia/Tokyo","language":"ja"}'
# timezone is NOT validated: a typo silently becomes GMT — copy the IANA name exactly

# traffic through the proxy, GPS / timezone / locale from your own values —
# a deliberate mismatch (IP in one country, GPS in another); geo.source decides what the hooks use
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e proxy '{"enabled":true,"host":"10.0.0.1","port":1080,"protocol":"SOCKS5"}'
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e geo '{"source":"CUSTOM","latitude":35.6812,"longitude":139.7671,"countryCode":"JP","timezone":"Asia/Tokyo","language":"ja"}'

# every flag is already ON (except hook_spoof_uptime), so most profiles skip this step.
# an update REPLACES the whole map — read it first, then send it back complete:
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.get --extra token:s:<your_access_token> --extra id:s:<profile_id>

# example: Wi-Fi + Bluetooth spoofing off, uptime spoofing on, everything else at its default
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e hookFlags '{"hook_hide_dev_opts":true,"hook_hide_vpn":true,"hook_hide_airplane_mode":true,"hook_hide_proxy":true,"hook_hide_root":true,"hook_hide_lsposed":true,"hook_spoof_installer":true,"hook_package_info":true,"hook_lan_scan_block":true,"hook_identifiers_partly":true,"hook_identifiers_fully":true,"hook_wifi":false,"hook_nearby_wifi":true,"hook_nearby_bluetooth":false,"hook_realistic_sensor":true,"hook_sensor_accelerometer":true,"hook_sensor_gyroscope":true,"hook_sensor_light":true,"hook_spoof_uptime":true,"hook_virtual_accounts":true,"hook_geo_gps":true,"hook_geo_locale":true,"hook_geo_timezone":true}'

# activating wipes the target apps' data — if the CURRENTLY active profile has anything worth keeping, save it first
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method status --extra token:s:<your_access_token>
# → "activeProfileId" is the profile to back up

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.start --extra token:s:<your_access_token> --extra id:s:<active_profile_id>
# → {"jobId":"f0e1d2c3-...", "type":"backup", ...} — poll until "state" is DONE (or FAILED):
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method backup.job --extra token:s:<your_access_token> --extra jobId:s:<job_id>

# later, once that profile is active again, pour it back:
# adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method restore.start --extra token:s:<your_access_token> --extra id:s:<active_profile_id>

# force-stops every target app, CLEARS ITS DATA, and brings it back with the new identity.
# no confirmation dialog — this comment is the only warning you get
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.setActive --extra token:s:<your_access_token> --extra id:s:<profile_id>
# → Bundle[{data={"id":"a1b2...","isActive":true}, ok=true}]
# BUSY? a backup / restore job still holds the slot — retry until it stops

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.get --extra token:s:<your_access_token> --extra id:s:<profile_id>
# → "isActive":true, "deviceMock":{"enabled":true,...}, "sim":{"enabled":true,"simCards":[...]}, "proxy":{...}, "geo":{...}

adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method status --extra token:s:<your_access_token>
# → "activeProfileId":"<profile_id>"

# a second identity with the same settings — device re-rolled, SIM numbers regenerated, name generated
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.duplicate --extra token:s:<your_access_token> --extra id:s:<profile_id>

# stop spoofing (no id needed — it deactivates whichever profile is active)
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.deactivate --extra token:s:<your_access_token>

# delete the profile — its backups under /sdcard/HideMyAndroid_Backups/ go with it
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.delete --extra token:s:<your_access_token> --extra id:s:<profile_id>

Dua resep lengkap

Langkah-langkah di atas, masing-masing dipadatkan menjadi satu blok salin-dan-jalankan. A adalah jalur terpendek pada 1.5.9+; B sepenuhnya menghindari generator dan proxy, dan berfungsi pada 1.4.5+. Ganti <profile_id> setelah perintah pertama pada keduanya.

# Recipe A — everything generated (app 1.5.9+). The shortest path to a working profile.

# 1. create — copy the returned id into <profile_id> below
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.create --extra token:s:<your_access_token> --extra name:s:Demo

# 2. target app
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.addApp --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.whatsapp

# 3. virtual Gmail account
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'gmails:s:["[email protected]"]'

# 4. device + SIM in one call — a random device, slot 0 US, slot 1 GB (both enabled and saved)
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e simCountries '["US","GB"]' -e deviceTemplate random

# 5. proxy — tested live (~8s); the location follows it
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e proxy '{"enabled":true,"host":"10.0.0.1","port":1080,"protocol":"SOCKS5"}'

# 6. activate — clears the target app's data
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.setActive --extra token:s:<your_access_token> --extra id:s:<profile_id>

# 7. verify
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.get --extra token:s:<your_access_token> --extra id:s:<profile_id>

# Recipe B — everything by hand (app 1.4.5+). No generator, no proxy: you control every value.

# 1. create — copy the returned id into <profile_id> below
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.create --extra token:s:<your_access_token> --extra name:s:Demo

# 2. target app
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.addApp --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra packageName:s:com.whatsapp

# 3. virtual Gmail accounts
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.update --extra token:s:<your_access_token> --extra id:s:<profile_id> --extra 'gmails:s:["[email protected]","[email protected]"]'

# 4. device — every Build field yourself
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e deviceMock '{"enabled":true,"manufacturer":"Samsung","brand":"samsung","model":"SM-S918B","device":"dm3q","product":"dm3qxxx","board":"kalama","hardware":"qcom","buildId":"UP1A.231005.007","buildIncremental":"S918BXXU3CWK9","buildType":"user","buildTags":"release-keys","buildFingerprint":"samsung/dm3qxxx/dm3q:14/UP1A.231005.007/S918BXXU3CWK9:user/release-keys","deviceName":"Galaxy S23 Ultra"}'

# 5. SIM — two cards, every field yourself
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e sim '{"enabled":true,"simCards":[{"slotIndex":0,"carrierName":"AT&T","countryIso":"us","mcc":"310","mnc":"410","operatorCode":"310410","networkType":"LTE","phoneNumber":"+12025550123","iccid":"8901410123456789012","imsi":"310410123456789"},{"slotIndex":1,"carrierName":"T-Mobile","countryIso":"us","mcc":"310","mnc":"260","operatorCode":"310260","networkType":"NR 5G","phoneNumber":"+12025550456","iccid":"8901260987654321098","imsi":"310260987654321"}]}'

# 6. location — custom, no proxy (all four fields required; timezone is not validated)
adb shell am broadcast -a com.wowsoftware.hidemyandroid.HEADLESS_UPDATE -p com.wowsoftware.hidemyandroid -e token <your_access_token> -e id <profile_id> -e geo '{"source":"CUSTOM","latitude":35.6812,"longitude":139.7671,"countryCode":"JP","timezone":"Asia/Tokyo","language":"ja"}'

# 7. activate — clears the target app's data
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.setActive --extra token:s:<your_access_token> --extra id:s:<profile_id>

# 8. verify
adb shell content call --uri content://com.wowsoftware.hidemyandroid.headless --method profile.get --extra token:s:<your_access_token> --extra id:s:<profile_id>

Kode error

Saat gagal, Anda akan mendapatkan ok=false dengan salah satu nilai error_code berikut (broadcast mengembalikan result=1):

Tips & pemecahan masalah

• Broadcast tidak melakukan apa pun? Pastikan Anda menyertakan -p com.wowsoftware.hidemyandroid — Android memblokir broadcast tanpanya.
• Nilai terpotong setelah :? Nilai tersebut mengandung tanda titik dua, sehingga content call memotongnya. Kirim melalui broadcast HEADLESS_UPDATE.
• Broadcast JSON tidak diterapkan (sering terjadi di Windows)? Di shell desktop dan shell perangkat, tanda kutip dalam JSON am broadcast (hookFlags, proxy, deviceMock, sim) mudah terhapus, sehingga am salah membaca nilai tersebut (mungkin terlihat sebagai URI data dat=…) dan tidak ada yang berubah. Solusi yang andal adalah menjaga JSON di luar baris perintah — taruh seluruh alur kerja dalam file .sh (tanda kutip tunggal menjaga setiap JSON tetap utuh), lalu push dan jalankan di perangkat. Skrip berjalan di perangkat, sehingga dapat menangkap id profil baru dan menggunakannya kembali:
  bash Copy

  # setup.sh — Recipe A from the full example as one runnable script (runs on the device)
  URI=content://com.wowsoftware.hidemyandroid.headless
  PKG=com.wowsoftware.hidemyandroid
  K=<your_access_token>
  
  # 1. create a profile and capture its id
  ID=$(content call --uri $URI --method profile.create --extra token:s:$K --extra name:s:Demo | grep -o '"id":"[^"]*"' | head -n1 | sed 's/.*"id":"//;s/"//')
  echo "profile id: $ID"
  
  # 2. add a target app
  content call --uri $URI --method profile.addApp --extra token:s:$K --extra id:s:$ID --extra packageName:s:com.facebook.katana
  
  # 3. add the virtual Gmail accounts
  content call --uri $URI --method profile.update --extra token:s:$K --extra id:s:$ID --extra 'gmails:s:["[email protected]","[email protected]"]'
  
  # 4. device + SIM generated from the database (1.5.9+): random device, slot 0 US, slot 1 GB
  am broadcast -a $PKG.HEADLESS_UPDATE -p $PKG -e token $K -e id $ID -e simCountries '["US","GB"]' -e deviceTemplate random
  #    Recipe B alternative (any version) — write both blocks yourself instead:
  # am broadcast -a $PKG.HEADLESS_UPDATE -p $PKG -e token $K -e id $ID -e deviceMock '{"enabled":true,"manufacturer":"Samsung","brand":"samsung","model":"SM-S918B","device":"dm3q","product":"dm3qxxx","board":"kalama","hardware":"qcom","buildId":"UP1A.231005.007","buildIncremental":"S918BXXU3CWK9","buildType":"user","buildTags":"release-keys","buildFingerprint":"samsung/dm3qxxx/dm3q:14/UP1A.231005.007/S918BXXU3CWK9:user/release-keys","deviceName":"Galaxy S23 Ultra"}'
  # am broadcast -a $PKG.HEADLESS_UPDATE -p $PKG -e token $K -e id $ID -e sim '{"enabled":true,"simCards":[{"slotIndex":0,"carrierName":"AT&T","countryIso":"us","mcc":"310","mnc":"410","operatorCode":"310410","networkType":"LTE","phoneNumber":"+12025550123","iccid":"8901410123456789012","imsi":"310410123456789"},{"slotIndex":1,"carrierName":"T-Mobile","countryIso":"us","mcc":"310","mnc":"260","operatorCode":"310260","networkType":"NR 5G","phoneNumber":"+12025550456","iccid":"8901260987654321098","imsi":"310260987654321"}]}'
  
  # 5. enable + set the proxy (tested live, ~8s) — the location follows it
  am broadcast -a $PKG.HEADLESS_UPDATE -p $PKG -e token $K -e id $ID -e proxy '{"enabled":true,"host":"10.0.0.1","port":1080,"protocol":"SOCKS5"}'
  #    Or skip the proxy and set the location yourself (use INSTEAD of the proxy line, not after it):
  # am broadcast -a $PKG.HEADLESS_UPDATE -p $PKG -e token $K -e id $ID -e geo '{"source":"CUSTOM","latitude":35.6812,"longitude":139.7671,"countryCode":"JP","timezone":"Asia/Tokyo","language":"ja"}'
  
  # 6. activate (restarts the target app and clears its data)
  content call --uri $URI --method profile.setActive --extra token:s:$K --extra id:s:$ID
  
  # 7. verify
  content call --uri $URI --method profile.get --extra token:s:$K --extra id:s:$ID

  kemudian push ke perangkat dan jalankan:
  bash Copy

  adb push setup.sh /data/local/tmp/setup.sh
  adb shell sh /data/local/tmp/setup.sh

  Perintah content call biasa (tanpa JSON) dapat diketikkan langsung tanpa skrip. Di Git Bash, tambahkan awalan MSYS_NO_PATHCONV=1 pada baris adb agar path di perangkat tidak ditulis ulang.
• Perubahan tidak muncul? Aplikasi target harus restart — mengaktifkan profil akan melakukan ini secara otomatis, sekaligus menghapus data aplikasi tersebut pada langkah yang sama, sehingga ia hidup dengan identitas baru tanpa membawa apa pun dari sebelumnya.
• PROXY_INVALID untuk proxy yang Anda percaya? Perangkat memerlukan internet untuk pengujian, dibatasi ~8 detik, sehingga proxy yang lambat dapat timeout.
• BUSY dari tugas yang sudah Anda batalkan? backup.cancel seketika mengubah tugas menjadi CANCELLED (dan mengisi finishedAt), tetapi tar yang diluncurkannya tidak dapat diputus dan terus berjalan, sehingga slotnya tetap tertahan. backup.job menampilkan CANCELLED saat slotnya masih sibuk, dan tidak ada kolom yang melaporkan slot itu — jangan anggap CANCELLED sebagai “slot bebas”; cukup ulangi profile.setActive / deactivate / delete sampai tidak lagi mengembalikan BUSY. (Tugas yang berakhir wajar di DONE atau FAILED membebaskan slotnya hampir seketika.)
• Binding not well formed untuk id templat yang Anda salin langsung dari device.templates? Templat hasil impor memiliki id yang diawali custom:, dan titik dua itu merusak bentuk key:type:value dari --extra — alat content mencetak [ERROR] Binding not well formed beserta teks penggunaannya dan permintaan tidak pernah sampai ke aplikasi. Kirim lewat broadcast HEADLESS_UPDATE sebagai gantinya (-e deviceTemplate 'custom:…'). Id bawaan (brand|product|model) tidak mengandung titik dua dan bekerja lewat kedua transport — tetapi apit dengan tanda kutip tunggal, atau shell membaca | sebagai pipe (sh: e3qxeea: not found) dan tidak ada yang terkirim sama sekali.