2021-03-12 06:32:12 +00:00
### Abaddon
---
Alternative Discord client made in C++ with GTK
2020-11-16 02:00:20 +00:00
2021-03-12 06:32:12 +00:00
< img src = "/.readme/s3.png" >
Current features:
* Not Electron
* Handles most types of chat messages including embeds, images, and replies
* Completely styleable/customizable with CSS (if you have a system GTK theme it won't really use it though)
* Identifies to gateway as the web client unlike other clients so less likely to be falsely flagged as spam< sup > 1</ sup >
* Set status
* Start new DMs and group DMs
* View user profiles (notes, mutual servers, mutual friends)
* Kick, ban, and unban members
* Modify roles and modify members' roles
* Manage invites
2021-03-18 03:55:41 +00:00
* Manage emojis
2021-03-12 06:32:12 +00:00
* View audit log
* Emojis< sup > 2</ sup >
* Animated avatars, server icons, emojis (can be turned off)
1 - Other third-party clients send the IDENTIFY message that bots use which makes Discord more likely to think you are selfbotting or spamming. However, Discord still loves to ban people's accounts for no good reason, even users of the official clients. If you want to be really careful avoid joining servers really fast or cold DMing people.
2 - Getting emojis to function properly on GTK is still something I've yet to figure out ([#5](../../issues/5)). Unicode emojis are manually searched for and replaced in several places as opposed to allowing GTK to figure it out since GTK's way of doing it doesn't work very well.
### Building manually (recommended if not on Windows):
2020-09-05 05:09:46 +00:00
#### Windows:
2020-12-19 04:59:33 +00:00
1. `git clone https://github.com/uowuo/abaddon && cd abaddon`
2021-01-23 21:07:03 +00:00
2. `vcpkg install gtkmm:x64-windows nlohmann-json:x64-windows ixwebsocket:x64-windows zlib:x64-windows simpleini:x64-windows sqlite3:x64-windows openssl:x64-windows curl:x64-windows`
2020-09-09 21:37:09 +00:00
3. `mkdir build && cd build`
4. `cmake -G"Visual Studio 16 2019" -A x64 -DCMAKE_TOOLCHAIN_FILE=c:\path\to\vcpkg\scripts\buildsystems\vcpkg.cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo -DVCPKG_TARGET_TRIPLET=x64-windows ..`
2021-01-07 07:41:49 +00:00
5. Build with Visual Studio
Or, do steps 1 and 2, and open CMakeLists.txt in Visual Studio if `vcpkg integrate install` was run
2020-09-05 05:09:46 +00:00
2021-01-07 07:41:49 +00:00
#### Mac:
1. `git clone https://github.com/uowuo/abaddon && cd abaddon`
2021-01-23 21:07:03 +00:00
2. `brew install gtkmm3 nlohmann-json`
2021-01-07 07:41:49 +00:00
3. `mkdir build && cd build`
4. `cmake ..`
5. `make`
#### Linux:
2021-01-23 21:07:03 +00:00
1. Install dependencies: `libgtkmm-3.0-dev` , `libcurl4-gnutls-dev` , and [nlohmann-json ](https://github.com/nlohmann/json )
2021-01-07 07:41:49 +00:00
2. `git clone https://github.com/uowuo/abaddon && cd abaddon`
3. `mkdir build && cd build`
4. `cmake ..`
5. `make`
2020-09-05 05:09:46 +00:00
2020-09-09 21:37:09 +00:00
### Downloads (from CI):
2021-01-08 00:11:21 +00:00
- Windows: [here ](https://nightly.link/uowuo/abaddon/workflows/ci/master/build-windows-RelWithDebInfo.zip )
2021-01-23 21:07:03 +00:00
- MacOS: [here ](https://nightly.link/uowuo/abaddon/workflows/ci/master/build-macos-RelWithDebInfo.zip ) unsigned, unpackaged, requires gtkmm3 (e.g. from homebrew)
- Linux: [here ](https://nightly.link/uowuo/abaddon/workflows/ci/master/build-linux-MinSizeRel.zip ) unpackaged (for now), requires gtkmm3. built on Ubuntu 18.04 + gcc9
2021-01-18 06:35:27 +00:00
2021-03-12 06:32:12 +00:00
⚠️ Make sure you start from the directory where `css` and `res` are or else stuff will be broken
2020-09-09 21:37:09 +00:00
#### Dependencies:
2020-08-26 02:10:39 +00:00
* [gtkmm ](https://www.gtkmm.org/en/ )
* [JSON for Modern C++ ](https://github.com/nlohmann/json )
* [IXWebSocket ](https://github.com/machinezone/IXWebSocket )
2021-01-23 21:07:03 +00:00
* [libcurl ](https://curl.se/ )
2020-09-05 05:09:46 +00:00
* [zlib ](https://zlib.net/ )
* [simpleini ](https://github.com/brofield/simpleini )
2020-12-10 22:15:15 +00:00
* [SQLite3 ](https://www.sqlite.org/index.html )
2020-09-09 22:32:45 +00:00
2020-11-16 02:00:20 +00:00
### TODO:
* Voice support
* Unread indicators
2021-03-12 06:32:12 +00:00
* User activities
2020-11-16 02:00:20 +00:00
* Nicknames
2021-03-12 06:32:12 +00:00
* More server management stuff
* Manage friends
2020-11-16 02:00:20 +00:00
* A bunch of other stuff
2020-09-09 22:32:45 +00:00
### Styling
#### CSS selectors
2021-03-12 06:32:12 +00:00
.app-window - Applied to all windows. This means the main window and all popups
.app-popup - Additional class for `.app-window` s when the window is not the main window
2020-09-09 22:32:45 +00:00
.channel-list - Container of the channel list
.channel-row - All rows within the channel container
.channel-row-channel - Only rows containing a channel
.channel-row-category - Only rows containing a category
.channel-row-guild - Only rows containing a guild
.channel-row-label - All labels within the channel container
2021-03-12 06:32:12 +00:00
.nsfw - Applied to channel row labels and their container for NSFW channels
2020-09-09 22:32:45 +00:00
.messages - Container of user messages
.message-container - The container which holds a user's messages
.message-container-author - The author label for a message container
.message-container-timestamp - The timestamp label for a message container
2021-03-12 06:32:12 +00:00
.message-container-avatar - Avatar for a user in a message
2020-10-06 02:46:44 +00:00
.message-container-extra - Label containing BOT/Webhook
2021-01-01 06:48:35 +00:00
.message-text - The text of a user message
2021-04-03 06:40:37 +00:00
.pending - Extra class of .message-text for messages pending to be sent
.failed - Extra class of .message-text for messages that failed to be sent
2021-01-01 06:48:35 +00:00
.message-attachment-box - Contains attachment info
.message-reply - Container for the replied-to message in a reply (these elements will also have .message-text set)
2021-03-12 06:32:12 +00:00
.message-input - Applied to the chat input container
2021-03-14 22:59:52 +00:00
.replying - Extra class for chat input container when a reply is currently being created
2021-01-01 06:48:35 +00:00
.reaction-box - Contains a reaction image and the count
.reacted - Additional class for reaction-box when the user has reacted with a particular reaction
.reaction-count - Contains the count for reaction
.completer - Container for the message completer
.completer-entry - Container for a single entry in the completer
.completer-entry-label - Contains the label for an entry in the completer
.completer-entry-image - Contains the image for an entry in the completer
2020-09-09 22:32:45 +00:00
.embed - Container for a message embed
.embed-author - The author of an embed
.embed-title - The title of an embed
.embed-description - The description of an embed
.embed-field-title - The title of an embed field
.embed-field-value - The value of an embed field
.embed-footer - The footer of an embed
.members - Container of the member list
.members-row - All rows within the members container
.members-row-label - All labels in the members container
.members-row-member - Rows containing a member
2021-01-01 06:48:35 +00:00
.members-row-role - Rows containing a role
.members-row-avatar - Contains the avatar for a row in the member list
2021-01-27 20:45:21 +00:00
.status-indicator - The status indicator
.online - Applied to status indicators when the associated user is online
.idle - Applied to status indicators when the associated user is away
.dnd - Applied to status indicators when the associated user is on do not disturb
.offline - Applied to status indicators when the associated user is offline
2021-03-14 22:59:52 +00:00
.typing-indicator - The typing indicator (also used for replies)
2021-03-12 06:32:12 +00:00
Used in reorderable list implementation:
.drag-icon
.drag-hover-top
.drag-hover-bottom
Used in guild settings popup:
.guild-settings-window
.guild-members-pane-list - Container for list of members in the members pane
.guild-members-pane-info - Container for member info
.guild-roles-pane-list - Container for list of roles in the roles pane
Used in profile popup:
.mutual-friend-item - Applied to every item in the mutual friends list
.mutual-friend-item-name - Name in mutual friend item
.mutual-friend-item-avatar - Avatar in mutual friend item
.mutual-guild-item - Applied to every item in the mutual guilds list
.mutual-guild-item-name - Name in mutual guild item
.mutual-guild-item-icon - Icon in mutual guild item
.mutual-guild-item-nick - User nickname in mutual guild item
.profile-connection - Applied to every item in the user connections list
.profile-connection-label - Label in profile connection item
.profile-connection-check - Checkmark in verified profile connection items
.profile-connections - Container for profile connections
.profile-notes - Container for notes in profile window
.profile-notes-label - Label that says "NOTE"
.profile-notes-text - Actual note text
.profile-info-pane - Applied to container for info section of profile popup
.profile-info-created - Label for creation date of profile
.user-profile-window
.profile-main-container - Inner container for profile
.profile-avatar
.profile-username
.profile-switcher - Buttons used to switch viewed section of profile
.profile-stack - Container for profile info that can be switched between
.profile-badges - Container for badges
.profile-badge
2021-01-27 20:45:21 +00:00
2021-01-01 06:48:35 +00:00
### Settings
Settings are configured (for now) by editing abaddon.ini
2021-03-12 06:32:12 +00:00
You should edit these while the client is closed even though there's an option to reload while running
2021-01-01 06:48:35 +00:00
This listing is organized by section.
For example, memory_db would be set by adding `memory_db = true` under the line `[discord]`
#### discord
* memory_db (true or false, default false) - if true, Discord data will be kept in memory as opposed to on disk
* token (string) - Discord token used to login, this can be set from the menu
* prefetch (true or false, default false) - if true, new messages will cause the avatar and image attachments to be automatically downloaded
#### http
* user_agent (string) - sets the user-agent to use in HTTP requests to the Discord API (not including media/images)
* concurrent (int, default 10) - how many images can be concurrently retrieved
#### gui
* member_list_discriminator (true or false, default true) - show user discriminators in the member list
2021-05-24 06:03:42 +00:00
* stock_emojis (true or false, default true) - allow abaddon to substitute unicode emojis with images from emojis.bin, must be false to allow GTK to render emojis itself
* custom_emojis (true or false, default true) - download and use custom Discord emojis
2021-01-01 06:48:35 +00:00
* css (string) - path to the main CSS file
* animations (true or false, default true) - use animated images where available (e.g. server icons, emojis, avatars). false means static images will be used
2021-03-04 05:02:37 +00:00
* owner_crown (true or false, default true) - show a crown next to the owner
2021-06-03 23:23:33 +00:00
* gateway (string) - override url for Discord gateway. must be json format and use zlib stream compression
* api_base (string) - override base url for Discord API
2020-09-09 22:32:45 +00:00
2021-01-01 06:48:35 +00:00
#### misc
* linkcolor (string) - color to use for links in messages
