Skip to content

Commit

Permalink
Initialize git repository
Browse files Browse the repository at this point in the history
  • Loading branch information
amanharwara committed Sep 26, 2018
1 parent 09e0bbe commit f3c1b58
Show file tree
Hide file tree
Showing 1,379 changed files with 218,706 additions and 2 deletions.
59 changes: 57 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,57 @@
# altus
Electron-based desktop client for Whatsapp Web with theme support and native notifications
# Altus

**Altus** is an Electron-based WhatsApp client that works on almost all of the desktop platforms, i.e., Windows, Mac and Linux.

![Altus Banner](/img/altus-banner.png)

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.

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

### Planned Features

- [ ] **Theme Customizer** so you don't have to learn CSS to create themes
- [ ] **Import/Export Settings** to import/export settings as JSON files
- [ ] **Inbuilt YouTube Video Preview** to view YouTube videos without having to open your browser
- [ ] **Multiple Account Support** to use multiple WhatsApp accounts simultaneously.

## Screenshots

![Altus](/img/altus.png)

![altus-dark-mode](/img/altus-dark-mode.png)

![altus-custom-theme-window](/img/altus-custom-theme.png)

![altus-preferences](/img/altus-preferences.png)

## Downloads

Downloads for any of the platforms are available on the releases page on the repository or on the Downloads page on my website. Help for installation regarding any of the platforms is provided below.

#### Windows

To install the app for Windows, simply run the setup which will probably be named as `Altus-Setup-x.x.x.exe` where *x.x.x* is the version number. The setup will guide you through your installation. Currently, the setup will add a shortcut to the desktop and the start menu and install to `C:\Program Files\Altus` or `C:\Users\(User)\AppData\Local\Programs\Altus` depending on what you select during the installation.

#### Linux

Installation will be different depending on your Linux distribution. You can download either of the Linux file available i.e. `altus-x.x.x-x86_64.AppImage` or `altus_x.x.x_amd64.deb` according to your distribution.

It is recommended you use the file with `.AppImage` extension as it an almost-universal file distribution format for linux which is very convenient. If you use the `AppImage` file you will not have to worry about what distribution you are using; you can just run the `AppImage` file and it will run the program.

If you have a Debian-based distribution like Ubuntu, you can use Debian-specific `.deb` file. On some distros like Ubuntu, you can just double-click to install the file or you can use `dpkg` to install it. E.g.: `sudo dpkg -i path\to\deb`

#### Mac

Mac packages will take more time to get released because I do not own a proper Mac and have to use a virtual machine to package the app. Installation for Mac is simple. All you have to do is install the provided `.dmg` file.

### For Developers

I use electron-builder to build and distribute my app. However, it is not included as a dependency in the source code. Once you maybe clone this repo and make whatever changes you want to the app, you will need to either install electron-builder as a dependency using `npm install electron-builder --save-dev` or globally using `npm install -g electron-builder`. If you install electron-builder globally, you can just use `build -wml` or `build --dir` to package the app.
Binary file added img/altus-banner.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added img/altus-custom-theme.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added img/altus-dark-mode.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added img/altus-preferences.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added img/altus.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/build/altus-icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/build/background.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/build/icon.icns
Binary file not shown.
Binary file added src/build/icon.ico
Binary file not shown.
Binary file added src/build/installerSidebar.bmp
Binary file not shown.
21 changes: 21 additions & 0 deletions src/css/Dark Theme LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2018 vednoc

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
93 changes: 93 additions & 0 deletions src/css/about.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
body,
html {
margin: 0;
padding: 0;
width: 100%;
height: 100%;
}

* {
margin: 0;
padding: 0
}

body {
background: #4c4cff;
background: -moz-linear-gradient(45deg, #4c4cff 0%, #5952b3 100%);
background: -webkit-linear-gradient(45deg, #4c4cff 0%, #5952b3 100%);
background: linear-gradient(45deg, #4c4cff 0%, #5952b3 100%);
filter: progid: DXImageTransform.Microsoft.gradient(startColorstr='#4c4cff', endColorstr='#5952b3', GradientType=1);
display: flex;
flex-direction: column;
padding: 20px;
box-sizing: border-box;
}

.header-container {
display: flex;
width: 100%;
flex-direction: row-reverse;
margin: 0px 0px 10px 0px;
}

.exit-container,
.exit-container * {
color: white;
font-size: 2rem;
font-weight: bolder;
}

.main-container {
display: flex;
flex-direction: row;
}

.altus-desc {
padding: 20px 10px;
display: flex;
flex-direction: column;
color: white;
text-align: center;
font-family: 'Raleway', 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
}

.altus-title {
font-size: 2rem;
padding: 0px 30px;
}

.altus-subtitle {
font-size: 1rem;
}

.altus-version {
font-size: 1.4rem;
font-weight: 300;
}

.footer-container {
display: flex;
flex-direction: row;
padding: 10px 50px;
text-align: center;
}

.website-text a,
.twitter-text a,
.github-text a {
color: white;
text-decoration: none;
font-family: 'Raleway', 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
padding: 0px 30px;
font-size: 1.2rem;
}

.website-text a:hover,
.twitter-text a:hover,
.github-text a:hover {
text-shadow: 0px 0px 2px rgba(255, 255, 255, 0.664);
}

.fa-heart {
color: #eb4267;
}
Loading

0 comments on commit f3c1b58

Please sign in to comment.