Skip to content
/ altus Public
forked from amanharwara/altus

Electron-based desktop client for WhatsApp Web with theme support, native notifications and multiple account support

License

Notifications You must be signed in to change notification settings

niuzb/altus

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Altus

GitHub All Releases Discord GitHub issues Say Thanks!

Altus is an Electron-based WhatsApp client with themes and multiple account support, available for Windows, Mac and Linux!

Altus Banner

The name Altus comes from the Latin adjective altus meaning "high, deep, noble or profound". The name was actually suggested by one of my friends.

Features

Altus uses the GitHub-produced Electron framework to wrap around WhatsApp Web and add extra features to it.

  • Multiple Account Support As of v2.0, you can use multiple Whatsapp accounts simultaneously!
  • Native notification support for all of the platforms.
  • Dark mode for when you need to chill out your eyes in the night (or even in the day)
  • Custom Theme Support If you know how to write CSS themes, you can create and use your own theme for WhatsApp.
  • Available for most desktop platforms including Windows (7 or above), Linux and MacOS.
  • Tray icon so you can minimize the app completely and still receive notifications.

Feature Requests

Submit a Feature Request - Click Here

Feature Requests

Screenshots

First Start

Altus First Start

Add New WhatsApp Instance

Altus Add Instance

Default WhatsApp Theme

Altus Default Theme

Dark WhatsApp Theme

Altus Dark Theme

Custom WhatsApp Theme Example

Altus Custom Theme

Releases

To download the latest releases, you can click here. Alternatively, you can visit the releases page on the repository or the downloads page on my website for all the releases available.


Installation :-

Windows

  • Run the .exe file provided in the release. E.g.: Altus-Setup-2.0.0.exe
  • If Windows displays a warning saying 'Windows protected your PC', click on More info and then click Run Anyway
  • Once the Altus Setup starts, you will be asked to select from two choices which are Anyone who uses this computer (all users) and Only for me (username)
    • If you select Anyone who uses this computer (all users), Altus will be installed to C:\Program Files\Altus and will be available for all the users on that machine.
    • If you select Only for me (username), Altus will be installed to C:\Users\(username)\AppData\Local\Programs\Altus and will only be available for that user (username).
  • Click Install. If it asks for admin privileges (UAC), click Yes
  • The installation will Altus will be installed to the path according to what you selected. You can select Run Altus if you want to start Altus after closing the setup.

Linux

I recommend using the .AppImage format since it allows you to use that single executable on the majority of Linux distributions. I am also not going to create .deb executables anymore since they aren't universal and are proprietary to Debian distributions unlike .AppImage executables which work on almost all of the distributions.

Installing Altus on Linux using AppImage is really easy. Follow these steps:

  • Download and move the AppImage file to wherever you want to. E.g: ~/Downloads/Altus 2.0.0.AppImage
  • You might need to make the file executable using chmod. Use: chmod a+x ~/Downloads/Altus 2.0.0.AppImage
  • Then simply run it. Use: ~/Downloads/Altus 2.0.0.AppImage

I recommend checking out TheAssasin/AppImageLauncher which will make it easier for you to use any AppImage easily by integrating them into your system like a debian package would be.

Mac

One thing to note is that Mac releases most probably will be late than the Windows and Linux releases as I do not own a Mac and my PC runs really slow when I use macOS on a VM.

To install Altus on a Mac, follow these steps:

  • Download the .dmg file
  • Double-click it i.e. run it
  • Drag the Altus icon onto the Applications folder
  • Let it copy
  • Done!

Latest Releases:

Windows - v2.1.0 - Download

Linux - v2.1.0 - Download

MacOS - v2.1.0 - Download

For Developers

Altus is an open-source app and I really appreciate other developers adding new features and/or helping fix bugs. If you want to contribute to Altus, you can fork this repository, make the changes and create a pull request. You can check out this tutorial to learn how to create a pull request.

However, please make sure you follow a few rules listed below to ensure that your changes get merged into the main repo. The rules listed below are enforced to make sure the changes made are well-documented and can be easily kept track of.

  • Make sure your pull request has a informative title. You should use prefixes like ADD:, FIX:, etc at the start of the title which describe the changes followed by a one-line description of the changes. Example: ADD: Added a new feature to Altus

  • Your pull request's description should be in-depth. Make sure you document all the changes you made as in-depth and informative as possible. Dependency changes and major code changes must be thoroughly described and given priority in your description.

  • Commits in your fork should be informative, as well. Make sure you don't combine too many changes into a single commit.

Acknowledgements

Below is the list of the dependencies that helped me greatly to create this app.

clipboard.js (zenorocha/clipboard.js) - used for copying generated CSS to the clipboard


custom-electron-titlebar (AlexTorresSk/custom-electron-titlebar) - used to create a custom titlebar instead of the plain titlebar that Electron has by default


electron-store (sindresorhus/electron-store) - used to store information of settings, tabs and themes


Mousetrap (ccampbell/mousetrap) - used for creating local shortcuts without registering accelerators


iziToast (marcelodolza/iziToast) - used for toast notifications when checking for updates

Contributors

Below is the list of contributors who have contributed to Altus by creating a feature or helping fix an issue.

dylanmcdougall - PR #10 (Added feature - Confirmation Dialog on close)

Dafnik - PR #5 (Helped fix issue #4)

About

Electron-based desktop client for WhatsApp Web with theme support, native notifications and multiple account support

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 80.6%
  • HTML 13.6%
  • CSS 5.8%