{"id":13856467,"url":"https://github.com/tgalal/yowsup-docker","last_synced_at":"2026-01-24T10:33:40.461Z","repository":{"id":34160986,"uuid":"38004352","full_name":"tgalal/yowsup-docker","owner":"tgalal","description":"Dockerfile for yowsup","archived":false,"fork":false,"pushed_at":"2020-06-05T10:10:12.000Z","size":5,"stargazers_count":33,"open_issues_count":8,"forks_count":23,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-05-13T14:33:09.252Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tgalal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-06-24T18:46:57.000Z","updated_at":"2024-10-10T04:57:14.000Z","dependencies_parsed_at":"2022-09-02T16:01:53.061Z","dependency_job_id":null,"html_url":"https://github.com/tgalal/yowsup-docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tgalal/yowsup-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tgalal%2Fyowsup-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tgalal%2Fyowsup-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tgalal%2Fyowsup-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tgalal%2Fyowsup-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tgalal","download_url":"https://codeload.github.com/tgalal/yowsup-docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tgalal%2Fyowsup-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28725366,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T10:24:43.181Z","status":"ssl_error","status_checked_at":"2026-01-24T10:24:36.112Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2024-08-05T03:01:01.422Z","updated_at":"2026-01-24T10:33:40.436Z","avatar_url":"https://github.com/tgalal.png","language":null,"funding_links":[],"categories":["Others"],"sub_categories":[],"readme":"[yowsup](https://github.com/tgalal/yowsup) is a python library that implements WhatsApp's protocol. Through this docker image you are able to access yowsup's command line client and run different commands such as sending messages, creating groups, updating profile and many other things.\n\n#Installation\n\n```docker pull tgalal/yowsup```\n\n#usage\n\nAdd ```--debug``` to any of the commands to get an insight on the actual protocol and see all incoming and outgoing data in your console.\n\nyowsup will need access to a persistent storage to store generated keys data inside, used at registration and for login with e2e encryption enabled to work. Therefore you'll need to mount a host dir at /root/.yowsup in each docker run command.\n\n##Registration\n\n### Step 1 request code\n```\ndocker run -v SOMEDIR:/root/.yowsup tgalal/yowsup registration --cc COUNTRYCODE --phone NUMBER --requestcode sms\n```\n\nor\n\n```\ndocker run -v SOMEDIR:/root/.yowsup tgalal/yowsup registration --cc COUNTRYCODE --phone NUMBER --requestcode voice\n```\n\nnote that the phone number must also begin with the specified country code\n\n### Step 2 verify code\n\n```\ndocker run -v SOMEDIR:/root/.yowsup tgalal/yowsup registration --cc COUNTRYCODE --phone NUMBER --register CODE\n```\n\nSave the returned password as you will need it for login\n\n##Clients\n### Command line client\n\t\n```\ndocker run -v SOMEDIR:/root/.yowsup -it tgalal/yowsup demos --login PHONE:PASSWORD --yowsup\n```\n\nThis will start yowsup shell, type /L to login\n\n```\nYowsup Cli client\n==================\nType /help for available commands\n\n\\[offline]: /L\n```\n\n### Echo client\n\nThis echoes back all received messages\n\n```\ndocker run -v SOMEDIR:/root/.yowsup tgalal/yowsup demos --login PHONE:PASSWORD --echo\n```\n\n### One shot client\n\nLogin, send a message, exit\n\n\n```\ndocker run -v SOMEDIR:/root/.yowsup tgalal/yowsup demos --login PHONE:PASSWORD --send CONTACT_PHONE MESSAGE\n```\n\n## E2E encryption\nTo use e2e encryption in any of the clients, pass --moxie in any of the commands. For example:\n\n```\ndocker run -v SOMEDIR:/root/.yowsup -it tgalal/yowsup demos --login PHONE:PASSWORD --yowsup --moxie\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftgalal%2Fyowsup-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftgalal%2Fyowsup-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftgalal%2Fyowsup-docker/lists"}