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+, dan seluruh grup pencadangan / pemulihan memerlukan 1.5.3+. 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 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. Lima belas sisanya — status, semua operasi baca, 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 tujuh extra — name, hookFlags, proxy, geo, deviceMock, sim, gmails — sehingga name dan gmails bisa lewat kedua transport. Tabel di atas soal mana yang lebih praktis, bukan mana yang mungkin. Extra apa pun yang namanya tidak termasuk dalam tujuh 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.3"}, 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.

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 20 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:

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"}'

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. 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"}]}'

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:["alice@gmail.com","bob@gmail.com"]'

Contoh lengkap

Pengaturan lengkap dari awal:

# 1. create a profile — 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. add a 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. add the 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:["alice@gmail.com","bob@gmail.com"]'

# 4. enable + set the device mock
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. enable + set the SIM mock (two cards, full fields)
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. enable + set the proxy (tested live, ~8s)
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"}'

# 7. pick where the location comes from — geo has two sources, choose ONE
#    A) from the proxy you just set. This is the default, so the line is optional:
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"}'
#    B) or set it yourself — this needs no proxy at all. Use B *instead of* A, not after 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 geo '{"source":"CUSTOM","latitude":35.6812,"longitude":139.7671,"countryCode":"JP","timezone":"Asia/Tokyo","language":"ja"}'
#    geo and proxy are independent: setting one never rewrites the other, and only
#    geo.source decides which one feeds the hooks. So CUSTOM together with a proxy in
#    a different country means your IP says one place while your GPS says another.

# 8. activate (restarts the target app and clears its 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>

# 9. 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 — 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:["alice@gmail.com","bob@gmail.com"]'
  
  # 4. enable + set the device mock
  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"}'
  
  # 5. enable + set the SIM mock (two cards)
  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"}]}'
  
  # 6. enable + set the proxy (tested live, ~8s)
  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"}'
  
  # 7. pick where the location comes from — geo has two sources, choose ONE
  #    A) from the proxy you just set. This is the default, so the line is optional:
  am broadcast -a $PKG.HEADLESS_UPDATE -p $PKG -e token $K -e id $ID -e geo '{"source":"PROXY"}'
  #    B) or set it yourself — this needs no proxy at all. Use B *instead of* A, 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"}'
  #    geo and proxy are independent: setting one never rewrites the other, and only
  #    geo.source decides which one feeds the hooks. So CUSTOM together with a proxy in
  #    a different country means your IP says one place while your GPS says another.
  
  # 8. activate (restarts the target app and clears its data)
  content call --uri $URI --method profile.setActive --extra token:s:$K --extra id:s:$ID
  
  # 9. 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.)