{"id":13588187,"url":"https://github.com/open-wa/wa-avd-docker","last_synced_at":"2025-12-30T00:22:59.355Z","repository":{"id":48631239,"uuid":"145880953","full_name":"open-wa/wa-avd-docker","owner":"open-wa","description":"A Docker image based on Ubuntu Desktop with VNC and noVNC access, that runs a lightweight Android Virtual Device with WhatsApp pre-installed.","archived":false,"fork":false,"pushed_at":"2021-07-16T21:04:18.000Z","size":63709,"stargazers_count":134,"open_issues_count":8,"forks_count":40,"subscribers_count":14,"default_branch":"master","last_synced_at":"2024-08-01T15:58:00.463Z","etag":null,"topics":["android","avd","docker","virtual-machine","whatsapp"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/yodascholtz/docker-android-whatsapp-avd/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/open-wa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-23T16:37:13.000Z","updated_at":"2024-07-24T12:09:41.000Z","dependencies_parsed_at":"2022-08-29T20:31:21.568Z","dependency_job_id":null,"html_url":"https://github.com/open-wa/wa-avd-docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-wa%2Fwa-avd-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-wa%2Fwa-avd-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-wa%2Fwa-avd-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-wa%2Fwa-avd-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/open-wa","download_url":"https://codeload.github.com/open-wa/wa-avd-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223300736,"owners_count":17122679,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","avd","docker","virtual-machine","whatsapp"],"created_at":"2024-08-01T15:06:33.489Z","updated_at":"2025-12-30T00:22:59.329Z","avatar_url":"https://github.com/open-wa.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Docker Android AVD with WhatsApp pre-installed\nA Docker image based on Ubuntu Desktop with VNC and noVNC access, that runs a lightweight Android Virtual Device.\n\nThe Dockerfile uses the following image as a base: [dorowu/ubuntu-desktop-lxde-vnc:xenial](https://hub.docker.com/r/dorowu/ubuntu-desktop-lxde-vnc/)\n\n## Deployment\n\n`docker-compose up --build`\n\n## Access noVNC\n\nVisit `localhost:6080`\n\n* Default username: `root`\n* Default password: `secret`\n\n## Start Android AVD\n\nUsing Supervisord to manage the services, the Android AVD should start up automatically with WhatsApp pre-installed. If it doesn't then...:\n\nRun the following command\n\n`${ANDROID_HOME}/tools/emulator @Pixel -gpu off`\n\nUsing `emulator` throws an error described somewhere on SO... can't recall where, anyway the fix is to call from directory directly.\n\n**NOTE**\n\nAt the moment the Docker entrypoint CMD/Supervisord isn't configuring the AVD. For now, to do it manually, run:\n\n`/app/entrypoint.sh`\n\n`/app/start-avd.sh`\n\nIn case you would like to start it with camera support (will take the screen from the VM as camera input):\n\n`/app/start-avd-with-cam.sh`\n\nAfter Android started, open your browser and open WhatsAppWeb or if you have the Matrix WhatsAppBridgeBot send login.\nThis should delivever you the QR code, now open in WhatsApp under option the \"WhatsAppWeb\", move with the Firefox window with QR code that it fits in the camera field of whatsapp.\nDepending on camera position it helps to rotate your mobile phone with the emulator buttons to be able to catch the QR code.\n\nFor more detail to bridge with matrix look here: https://matrix.org/docs/guides/whatsapp-bridging-mautrix-whatsapp \n\nPlease feel welcome to submit a pull-request to fix it!\n\n## Further Development\n\nI'd like to stream a VNC feed via the `v4l2loopback` kernel module into the Android AVD... WIP. This would allow one to scan WhatsApp web barcodes remotely.\n\n## Acknowledgements\n\n* [tracer0tong/android-emulator](https://github.com/tracer0tong/android-emulator)\n* [fcwu/docker-ubuntu-vnc-desktop](https://github.com/fcwu/docker-ubuntu-vnc-desktop)\n* [butomo1989/docker-android](https://github.com/butomo1989/docker-android)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-wa%2Fwa-avd-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopen-wa%2Fwa-avd-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-wa%2Fwa-avd-docker/lists"}