Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/eneshecan/whatsapp-for-linux

An unofficial WhatsApp desktop application for Linux.
https://github.com/eneshecan/whatsapp-for-linux

appindicator cmake cpp gtk3 gtkmm3-library gui linux webkit2gtk whatsapp

Last synced: about 2 months ago
JSON representation

An unofficial WhatsApp desktop application for Linux.

Host: GitHub
URL: https://github.com/eneshecan/whatsapp-for-linux
Owner: eneshecan
License: gpl-3.0
Created: 2020-05-27T18:47:44.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2024-04-25T08:18:24.000Z (5 months ago)
Last Synced: 2024-05-01T17:49:37.961Z (5 months ago)
Topics: appindicator, cmake, cpp, gtk3, gtkmm3-library, gui, linux, webkit2gtk, whatsapp
Language: C++
Homepage:
Size: 1.4 MB
Stars: 898
Watchers: 21
Forks: 92
Open Issues: 70
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/funding.yml
- License: LICENSE
- Code of conduct: .github/code_of_conduct.md

Awesome Lists containing this project

README

# WhatsApp for Linux

An unofficial WhatsApp desktop application for Linux.

[![Action Status](https://github.com/eneshecan/whatsapp-for-linux/workflows/Linter/badge.svg)](https://github.com/eneshecan/whatsapp-for-linux/actions/workflows/linter.yml)
[![Action Status](https://github.com/eneshecan/whatsapp-for-linux/workflows/Build/badge.svg)](https://github.com/eneshecan/whatsapp-for-linux/actions/workflows/build.yml)
[![Action Status](https://github.com/eneshecan/whatsapp-for-linux/workflows/Install/badge.svg)](https://github.com/eneshecan/whatsapp-for-linux/actions/workflows/install.yml)
[![Action Status](https://github.com/eneshecan/whatsapp-for-linux/workflows/Release/badge.svg)](https://github.com/eneshecan/whatsapp-for-linux/actions/workflows/release.yml)
[![POEditor](https://img.shields.io/badge/Translations-POEditor-brightgreen)](https://poeditor.com/join/project/jMGkxVn3vN)

![App Window](screenshot/app.png)

## About

WhatsApp for Linux is an unofficial WhatsApp desktop application written in C++ with the help of gtkmm and WebKitGtk libraries.
Check out [wiki](https://github.com/eneshecan/whatsapp-for-linux/wiki) for further details.

## Features

* Features come with WhatsApp Web
* WhatsApp specific keyboard shortcuts work with *Alt* key instead of *Cmd*
* Zoom in/out
* System tray icon
* Notification sounds
* Autostart with system
* Fullscreen mode
* Show/Hide headerbar by pressing *Alt+H*
* Localization support in system language
* Spell checking in system language. You need to install the corresponding dictionary to get this working i.e. `hunspell-en_us` package for US English
* Open chat by phone number

## Using WhatsApp for Linux

The application is available from a number of Linux distributions:

[![Packaging Status](https://repology.org/badge/vertical-allrepos/whatsapp-for-linux.svg)](https://repology.org/project/whatsapp-for-linux/versions)

## Dependencies

* cmake >= 3.12
* intltool
* gtkmm-3.0
* webkit2gtk-4.1
* ayatana-appindicator3-0.1
* libcanberra
* libhunspell (Optional for spell checking)

## Build & Run

### Development

```bash
# Create a debug build directory and go into it
mkdir -p build/debug && cd build/debug

# Build the project
cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr ../..
make -j4

# Optionally, to update the default translation file
make update-translation

# Run
./whatsapp-for-linux
```

### Local installation

```bash
# Run inside the build directory once the application is built
# You'll probably need administrator privileges for this
make install
```

### Uninstall

```bash
# Run inside the build directory if you want to uninstall all files
# install_manifest.txt file is created when you run make install
xargs rm < install_manifest.txt
```

## Packaging

### Debian

```bash
# Don't forget to update the version number (0) in debian/changelog before this
# Build the package.
dpkg-buildpackage -uc -us -ui
```

### Snap

```bash
# Build the package. Pass --use-lxd option in a virtual environment
snapcraft
```

### AppImage

```bash
# Make sure that the application is installed into the `/AppDir` directory
make install DESTDIR=../../AppDir

# Build the package
appimage-builder --skip-test --recipe ./appimage/AppImageBuilder.yml
```

## Contributing

Please read [contributing](CONTRIBUTING.md).

### Code Contributors

[![Code Contributors](https://opencollective.com/whatsapp-for-linux/contributors.svg?width=880&button=false)](https://github.com/eneshecan/whatsapp-for-linux/graphs/contributors)