mudslide

Mudslide

Send WhatsApp messages from the command-line, see also this Medium post.

This project is based on Baileys, a full-featured WhatsApp Web+Multi-Device API library (in case you're wondering about the name, a Mudslide is a Baileys cocktail).

Keep in mind that the working of Mudslide depends on the Baileys library and since that is not an official supported library by WhatsApp it could stop working without notice.

Table of Contents:

• Installation
• Usage
• Configuration
• Feedback, suggestions and bug reports
• Contributing
• License

Installation

Using npx, installation is not necessary. You can run Mudslide on a system with NodeJS 16 or higher from the command-line as follows:

npx mudslide -V

this should display the version number of the latest release.

Using npm Mudslide can be installed globally as follows:

npm install -g mudslide

Platform binaries

Binaries for different platforms (Linux, Windows) are available on the latest release page.

Docker

Mudslide can also run inside a Docker container, you can build the Docker image using the supplied Dockerfile:

docker build -t mudslide .

Test if the build was successful:

docker run -it mudslide

Since Mudslide keeps authentication state on disk you need to mount a state directory outside the container, for example:

docker run -v /home/<USERNAME>/.local/share/mudslide:/usr/src/app/cache login

Usage

Available commands and options can be listed with --help flag:

npx mudslide --help

for most command it's necessary that you've authorized Mudslide to interact with the WhatsApp API on your behalf. This can be done by logging in as described below.

Login

To login you need to authorize Mudslide from another device that has WhatsApp installed and scan the QR code printed in the terminal:

npx mudslide login
█▀▀▀▀▀█ ▀▀   ▀  █ █▀▀▀▀▀█
█ ███ █ █▄ █▀▀▀▀  █ ███ █
█ ▀▀▀ █ ▀█▀▀▄▀█▀▀ █ ▀▀▀ █
▀▀▀▀▀▀▀ ▀▄▀▄▀▄█▄▀ ▀▀▀▀▀▀▀
▀███▄ ▀▄▀▄   ▀▀ █▀ ▄▀▀▀▄▀
█▄▄▄▄ ▀ ▄  ▄▄▄█▄ ▄█▀ ▄▄  
▀▄ ▄▀ ▀ ▄█▄█ ▄ ▄ ██▄█ ▀▀█
▄▀▄██▀▀██▄▀ █▄▀▄▄█▀▄█ ▀▀▄
    ▀▀▀ ███▀▄▄  █▀▀▀█▀█▀█
█▀▀▀▀▀█   ▀▀█  ▄█ ▀ █ ▀██
█ ███ █ ▄▄█▀██▄▄▀██▀██▄▄▄
█ ▀▀▀ █ █▀▀▀▀▀ ▀▀█▀ █ █▀ 
▀▀▀▀▀▀▀ ▀▀▀ ▀ ▀  ▀ ▀▀▀▀▀▀

In the WhatsApp mobile app go to "Settings > Connected Devices > Connect Device" and scan the QR code. Wait until the status is "active", then you can exit Mudslide.

Logout

Logging out removes credentials from your local environment but will not disconnect Mudslide from your WhatsApp account, you can disconnect Mudslide using the WhatsApp app.

npx mudslide logout

Sending a message to yourself or a phone number

Using the recipient me you can send yourself a test message:

npx mudslide send me 'hello world'

To send a message to a phone number:

npx mudslide send 3161234567890 'hello world'

Use \n to send a message with a newline, for example:

npx mudslide send me 'hello\nworld'

Sending an image file

Image files (PNG, JPG, GIF) can be sent to individuals or groups:

npx mudslide send-image me image.png

npx mudslide send-group-image 123456789-987654321 image.jpg

Sending a location

Geographic locations can be sent to individuals or groups using latitude and longitude coordinates. For example, to position yourself at the Eiffel Tower:

npx mudslide send-location me 48.858222 2.2945

Or to send your location at the Sydney Opera House to a group:

npx mudslide send-group-location 123456789-987654321 -33.857058 151.214897

List your groups

To list all the groups you are participating in:

npx mudslide groups

this will show a list of group IDs and subjects.

Sending a message to a group

To send a message to a group you are particpating in you need the numerical group ID (see the mudslide groups command). Send a message to a group as follows:

npx mudslide send-group 123456789-987654321 'hello world'

Show current user details

To get the WhatsApp ID of the logged in user:

npx mudslide me

Configuration

By default WhatsApp credentials are cached in a folder located in the user's home directory. This folder is .local/share/mudslide' on Linux & macOS and AppData\Local\mudslide\Data on Windows.

A different location for the cache folder can be configured via the environment variable MUDSLIDE_CACHE_FOLDER or the -c/--cache options.

Development

Running unit-tests

To run the unit-tests run this command:

yarn test

Feedback, suggestions and bug reports

Please create an issue here: https://github.com/robvanderleek/mudslide/issues

Contributing

If you have suggestions for how Mudslide could be improved, or want to report a bug, open an issue! All and any contributions are appreciated.

License

ISC © 2022 Rob van der Leek [e-mail] (https://twitter.com/robvanderleek)