https://github.com/open-wa/wa-avd-docker

A Docker image based on Ubuntu Desktop with VNC and noVNC access, that runs a lightweight Android Virtual Device with WhatsApp pre-installed.
https://github.com/open-wa/wa-avd-docker

android avd docker virtual-machine whatsapp

Last synced: about 1 month ago
JSON representation

A Docker image based on Ubuntu Desktop with VNC and noVNC access, that runs a lightweight Android Virtual Device with WhatsApp pre-installed.

• Host: GitHub
• URL: https://github.com/open-wa/wa-avd-docker
• Owner: open-wa
• License: other
• Created: 2018-08-23T16:37:13.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2021-07-16T21:04:18.000Z (almost 3 years ago)
• Last Synced: 2023-11-07T17:15:29.525Z (8 months ago)
• Topics: android, avd, docker, virtual-machine, whatsapp
• Language: Shell
• Homepage: https://hub.docker.com/r/yodascholtz/docker-android-whatsapp-avd/
• Size: 60.8 MB
• Stars: 129
• Watchers: 14
• Forks: 38
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-stars - open-wa/wa-avd-docker - A Docker image based on Ubuntu Desktop with VNC and noVNC access, that runs a lightweight Android Virtual Device with WhatsApp pre-installed. (Shell)

README

        
# Docker Android AVD with WhatsApp pre-installed

A Docker image based on Ubuntu Desktop with VNC and noVNC access, that runs a lightweight Android Virtual Device.

The Dockerfile uses the following image as a base: [dorowu/ubuntu-desktop-lxde-vnc:xenial](https://hub.docker.com/r/dorowu/ubuntu-desktop-lxde-vnc/)

## Deployment

`docker-compose up --build`

## Access noVNC

Visit `localhost:6080`

* Default username: `root`

* Default password: `secret`

## Start Android AVD

Using Supervisord to manage the services, the Android AVD should start up automatically with WhatsApp pre-installed. If it doesn't then...:

Run the following command

`${ANDROID_HOME}/tools/emulator @Pixel -gpu off`

Using `emulator` throws an error described somewhere on SO... can't recall where, anyway the fix is to call from directory directly.

**NOTE**

At the moment the Docker entrypoint CMD/Supervisord isn't configuring the AVD. For now, to do it manually, run:

`/app/entrypoint.sh`

`/app/start-avd.sh`

In case you would like to start it with camera support (will take the screen from the VM as camera input):

`/app/start-avd-with-cam.sh`

After Android started, open your browser and open WhatsAppWeb or if you have the Matrix WhatsAppBridgeBot send login.

This 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.

Depending on camera position it helps to rotate your mobile phone with the emulator buttons to be able to catch the QR code.

For more detail to bridge with matrix look here: https://matrix.org/docs/guides/whatsapp-bridging-mautrix-whatsapp 

Please feel welcome to submit a pull-request to fix it!

## Further Development

I'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.

## Acknowledgements

* [tracer0tong/android-emulator](https://github.com/tracer0tong/android-emulator)

* [fcwu/docker-ubuntu-vnc-desktop](https://github.com/fcwu/docker-ubuntu-vnc-desktop)

* [butomo1989/docker-android](https://github.com/butomo1989/docker-android)