From c5807a3463aaefc89e2432730b997437305af59a Mon Sep 17 00:00:00 2001 From: abdalrzag eisa <53495583+Senpai-10@users.noreply.github.com> Date: Tue, 15 Nov 2022 10:47:16 +0300 Subject: Make README.md more readable (#120) * More noticeable warnings * Make CSS selectors stand out more from their description * Make Settings options stand out more from their description, and make the default value easy to see --- README.md | 212 +++++++++++++++++++++++++++++++------------------------------- 1 file changed, 106 insertions(+), 106 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 555b129..4f56568 100644 --- a/README.md +++ b/README.md @@ -92,7 +92,7 @@ Latest release version: https://github.com/uowuo/abaddon/releases/latest - 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 -⚠️ If you use Windows, make sure to start from the `bin` directory +> **Warning**: If you use Windows, make sure to start from the `bin` directory On Linux, `css` and `res` can also be loaded from `~/.local/share/abaddon` or `/usr/share/abaddon` @@ -135,90 +135,90 @@ spam filter's wrath: #### CSS selectors -.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 - -.channel-list - Container of the channel list - -.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 -.message-container-avatar - Avatar for a user in a message -.message-container-extra - Label containing BOT/Webhook -.message-text - The text of a user message -.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 -.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) -.message-input - Applied to the chat input container -.replying - Extra class for chat input container when a reply is currently being created -.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 - -.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 -.members-row-role - Rows containing a role -.members-row-avatar - Contains the avatar for a row in the member list - -.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 - -.typing-indicator - The typing indicator (also used for replies) +**`.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 + +**`.channel-list`** - Container of the channel list + +**`.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 +**`.message-container-avatar`** - Avatar for a user in a message +**`.message-container-extra`** - Label containing BOT/Webhook +**`.message-text`** - The text of a user message +**`.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 +**`.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) +**`.message-input`** - Applied to the chat input container +**`.replying`** - Extra class for chat input container when a reply is currently being created +**`.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 + +**`.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 +**`.members-row-role`** - Rows containing a role +**`.members-row-avatar`** - Contains the avatar for a row in the member list + +**`.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 + +**`.typing-indicator`** - The typing indicator (also used for replies) Used in reorderable list implementation: -.drag-icon .drag-hover-top .drag-hover-bottom +**`.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 +**`.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 +**`.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`** ### Settings @@ -234,46 +234,46 @@ For example, memory_db would be set by adding `memory_db = true` under the line #### discord -* 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 -* 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 +* **`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 +* **`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 20) - how many images can be concurrently retrieved +* **`user_agent`** (string) - sets the user-agent to use in HTTP requests to the Discord API (not including media/images) +* **`concurrent`** (int, `default: 20`) - how many images can be concurrently retrieved #### gui -* member_list_discriminator (true or false, default true) - show user discriminators in the member list -* stock_emojis (true or false, default true) - allow abaddon to substitute unicode emojis with images from emojis.bin, +* **`member_list_discriminator`** (true or false, `default: true`) - show user discriminators in the member list +* **`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 -* 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). +* **`custom_emojis`** (true or false, `default: true`) - download and use custom Discord emojis +* **`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 -* animated_guild_hover_only (true or false, default true) - only animate guild icons when the guild is being hovered +* **`animated_guild_hover_only`** (true or false, `default: true`) - only animate guild icons when the guild is being hovered over -* owner_crown (true or false, default true) - show a crown next to the owner -* unreads (true or false, default true) - show unread indicators and mention badges -* save_state (true or false, default true) - save the state of the gui (active channels, tabs, expanded channels) -* alt_menu (true or false, default false) - keep the menu hidden unless revealed with alt key -* hide_to_tray (true or false, default false) - hide abaddon to the system tray on window close +* **`owner_crown`** (true or false, `default: true`) - show a crown next to the owner +* **`unreads`** (true or false, `default: true`) - show unread indicators and mention badges +* **`save_state`** (true or false, `default: true`) - save the state of the gui (active channels, tabs, expanded channels) +* **`alt_menu`** (true or false, `default: false`) - keep the menu hidden unless revealed with alt key +* **`hide_to_tray`** (true or false, `default: false`) - hide abaddon to the system tray on window close #### style -* linkcolor (string) - color to use for links in messages -* expandercolor (string) - color to use for the expander in the channel list -* nsfwchannelcolor (string) - color to use for NSFW channels in the channel list -* channelcolor (string) - color to use for SFW channels in the channel list -* mentionbadgecolor (string) - background color for mention badges -* mentionbadgetextcolor (string) - color to use for number displayed on mention badges -* unreadcolor (string) - color to use for the unread indicator +* **`linkcolor`** (string) - color to use for links in messages +* **`expandercolor`** (string) - color to use for the expander in the channel list +* **`nsfwchannelcolor`** (string) - color to use for NSFW channels in the channel list +* **`channelcolor`** (string) - color to use for SFW channels in the channel list +* **`mentionbadgecolor`** (string) - background color for mention badges +* **`mentionbadgetextcolor`** (string) - color to use for number displayed on mention badges +* **`unreadcolor`** (string) - color to use for the unread indicator ### Environment variables -* ABADDON_NO_FC (Windows only) - don't use custom font config -* ABADDON_CONFIG - change path of configuration file to use. relative to cwd or can be absolute +* **`ABADDON_NO_FC`** (Windows only) - don't use custom font config +* **`ABADDON_CONFIG`** - change path of configuration file to use. relative to cwd or can be absolute -- cgit v1.2.3 From 86f6f81d9bec5407bb0d4b48acadb22eed9642ba Mon Sep 17 00:00:00 2001 From: abdalrzag eisa <53495583+Senpai-10@users.noreply.github.com> Date: Thu, 1 Dec 2022 03:56:22 +0300 Subject: add missing setting (#123) --- README.md | 133 +++++++++++++++++++++++++++++++------------------------------- 1 file changed, 67 insertions(+), 66 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 4f56568..6c2b191 100644 --- a/README.md +++ b/README.md @@ -135,101 +135,101 @@ spam filter's wrath: #### CSS selectors -**`.app-window`** - Applied to all windows. This means the main window and all popups +**`.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 **`.channel-list`** - Container of the channel list -**`.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 -**`.message-container-avatar`** - Avatar for a user in a message -**`.message-container-extra`** - Label containing BOT/Webhook -**`.message-text`** - The text of a user message -**`.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 -**`.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) -**`.message-input`** - Applied to the chat input container -**`.replying`** - Extra class for chat input container when a reply is currently being created -**`.reaction-box`** - Contains a reaction image and the count -**`.reacted`** - Additional class for reaction-box when the user has reacted with a particular reaction +**`.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 +**`.message-container-avatar`** - Avatar for a user in a message +**`.message-container-extra`** - Label containing BOT/Webhook +**`.message-text`** - The text of a user message +**`.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 +**`.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) +**`.message-input`** - Applied to the chat input container +**`.replying`** - Extra class for chat input container when a reply is currently being created +**`.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`** - 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 -**`.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`** - 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 -**`.members-row-role`** - Rows containing a role +**`.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 +**`.members-row-role`** - Rows containing a role **`.members-row-avatar`** - Contains the avatar for a row in the member list -**`.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 +**`.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 **`.typing-indicator`** - The typing indicator (also used for replies) -Used in reorderable list implementation: +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 +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 +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`** ### Settings -Settings are configured (for now) by editing abaddon.ini +Settings are configured (for now) by editing abaddon.ini The format is similar to the standard Windows ini format **except**: * `#` is used to begin comments as opposed to `;` * Section and key names are case-sensitive -You should edit these while the client is closed even though there's an option to reload while running -This listing is organized by section. +You should edit these while the client is closed even though there's an option to reload while running +This listing is organized by section. For example, memory_db would be set by adding `memory_db = true` under the line `[discord]` #### discord @@ -240,6 +240,7 @@ For example, memory_db would be set by adding `memory_db = true` under the line * **`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 +* **`autoconnect`** (true or false, `default: false`) - autoconnect to discord #### http -- cgit v1.2.3 From f0df06a795ed1db2fcd9a816d2c7728bf5623590 Mon Sep 17 00:00:00 2001 From: abdalrzag eisa <53495583+Senpai-10@users.noreply.github.com> Date: Fri, 2 Dec 2022 11:57:29 +0300 Subject: doc: list deps for building on Arch Linux (#125) --- README.md | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index 6c2b191..17eac77 100644 --- a/README.md +++ b/README.md @@ -75,6 +75,10 @@ the result of fundamental issues with Discord's thread implementation. ```Shell $ sudo apt install g++ cmake libgtkmm-3.0-dev libcurl4-gnutls-dev libsqlite3-dev libssl-dev nlohmann-json3-dev ``` + * On Arch Linux + ```Shell + $ sudo pacman -S gcc cmake gtkmm3 libcurl-gnutls lib32-sqlite lib32-openssl nlohmann-json libhandy + ``` 2. `git clone https://github.com/uowuo/abaddon --recurse-submodules="subprojects" && cd abaddon` 3. `mkdir build && cd build` 4. `cmake ..` -- cgit v1.2.3 From 33a329f16acf54dda813eba6cacb805f47aab425 Mon Sep 17 00:00:00 2001 From: Altoids1 Date: Fri, 2 Dec 2022 14:59:40 -0600 Subject: Fixes a few minor typos in the README (#127) --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 17eac77..46a4cc6 100644 --- a/README.md +++ b/README.md @@ -226,13 +226,14 @@ Used in profile popup: ### Settings -Settings are configured (for now) by editing abaddon.ini +Settings are configured (for now) by editing `abaddon.ini`. The format is similar to the standard Windows ini format **except**: * `#` is used to begin comments as opposed to `;` * Section and key names are case-sensitive -You should edit these while the client is closed even though there's an option to reload while running +> **Warning**: You should edit these while the client is closed, even though there's an option to reload while running. + This listing is organized by section. For example, memory_db would be set by adding `memory_db = true` under the line `[discord]` -- cgit v1.2.3 From c704703b14d7934c079b39b9225ae803cc48cb70 Mon Sep 17 00:00:00 2001 From: abdalrzag eisa <53495583+Senpai-10@users.noreply.github.com> Date: Sun, 4 Dec 2022 02:18:14 +0300 Subject: doc: Display `CSS selectors` and `Settings` as tables (#126) --- README.md | 231 ++++++++++++++++++++++++++++++++------------------------------ 1 file changed, 121 insertions(+), 110 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 46a4cc6..7e6fe30 100644 --- a/README.md +++ b/README.md @@ -139,90 +139,95 @@ spam filter's wrath: #### CSS selectors -**`.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 - -**`.channel-list`** - Container of the channel list - -**`.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 -**`.message-container-avatar`** - Avatar for a user in a message -**`.message-container-extra`** - Label containing BOT/Webhook -**`.message-text`** - The text of a user message -**`.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 -**`.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) -**`.message-input`** - Applied to the chat input container -**`.replying`** - Extra class for chat input container when a reply is currently being created -**`.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 - -**`.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 -**`.members-row-role`** - Rows containing a role -**`.members-row-avatar`** - Contains the avatar for a row in the member list - -**`.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 - -**`.typing-indicator`** - The typing indicator (also used for replies) +| Selector | Description | +|--------------------------------|---------------------------------------------------------------------------------------------------| +| `.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 | +| `.channel-list` | Container of the channel list | +| `.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 | +| `.message-container-avatar` | Avatar for a user in a message | +| `.message-container-extra` | Label containing BOT/Webhook | +| `.message-text` | The text of a user message | +| `.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 | +| `.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) | +| `.message-input` | Applied to the chat input container | +| `.replying` | Extra class for chat input container when a reply is currently being created | +| `.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 | +| `.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 | +| `.members-row-role` | Rows containing a role | +| `.members-row-avatar` | Contains the avatar for a row in the member list | +| `.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 | +| `.typing-indicator` | The typing indicator (also used for replies) | Used in reorderable list implementation: -**`.drag-icon`** **`.drag-hover-top`** **`.drag-hover-bottom`** +| Selector | +|----------------------| +| `.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 + +| Selector | Description | +|----------------------------|---------------------------------------------------| +| `.guild-settings-window` | Container for list of members in the members pane | +| `.guild-members-pane-list` | | +| `.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`** + +| Selector | Description | +|------------------------------|---------------------------------------------------------| +| `.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` | | ### Settings @@ -239,47 +244,53 @@ For example, memory_db would be set by adding `memory_db = true` under the line #### discord -* **`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 -* **`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 -* **`autoconnect`** (true or false, `default: false`) - autoconnect to discord +| Setting | Type | Default | Description | +|---------------|---------|---------|--------------------------------------------------------------------------------------------------| +| `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 | +| `memory_db` | boolean | 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` | boolean | false | if true, new messages will cause the avatar and image attachments to be automatically downloaded | +| `autoconnect` | boolean | false | autoconnect to discord | #### http -* **`user_agent`** (string) - sets the user-agent to use in HTTP requests to the Discord API (not including media/images) -* **`concurrent`** (int, `default: 20`) - how many images can be concurrently retrieved +| Setting | Type | Default | Description | +|--------------|--------|---------|---------------------------------------------------------------------------------------------| +| `user_agent` | string | | sets the user-agent to use in HTTP requests to the Discord API (not including media/images) | +| `concurrent` | int | 20 | how many images can be concurrently retrieved | #### gui -* **`member_list_discriminator`** (true or false, `default: true`) - show user discriminators in the member list -* **`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 -* **`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 -* **`animated_guild_hover_only`** (true or false, `default: true`) - only animate guild icons when the guild is being hovered - over -* **`owner_crown`** (true or false, `default: true`) - show a crown next to the owner -* **`unreads`** (true or false, `default: true`) - show unread indicators and mention badges -* **`save_state`** (true or false, `default: true`) - save the state of the gui (active channels, tabs, expanded channels) -* **`alt_menu`** (true or false, `default: false`) - keep the menu hidden unless revealed with alt key -* **`hide_to_tray`** (true or false, `default: false`) - hide abaddon to the system tray on window close +| Setting | Type | Default | Description | +|-----------------------------|---------|---------|----------------------------------------------------------------------------------------------------------------------------| +| `member_list_discriminator` | boolean | true | show user discriminators in the member list | +| `stock_emojis` | boolean | true | allow abaddon to substitute unicode emojis with images from emojis.bin, must be false to allow GTK to render emojis itself | +| `custom_emojis` | boolean | true | download and use custom Discord emojis | +| `css` | string | | path to the main CSS file | +| `animations` | boolean | true | use animated images where available (e.g. server icons, emojis, avatars). false means static images will be used | +| `animated_guild_hover_only` | boolean | true | only animate guild icons when the guild is being hovered over | +| `owner_crown` | boolean | true | show a crown next to the owner | +| `unreads` | boolean | true | show unread indicators and mention badges | +| `save_state` | boolean | true | save the state of the gui (active channels, tabs, expanded channels) | +| `alt_menu` | boolean | false | keep the menu hidden unless revealed with alt key | +| `hide_to_tray` | boolean | false | hide abaddon to the system tray on window close | #### style -* **`linkcolor`** (string) - color to use for links in messages -* **`expandercolor`** (string) - color to use for the expander in the channel list -* **`nsfwchannelcolor`** (string) - color to use for NSFW channels in the channel list -* **`channelcolor`** (string) - color to use for SFW channels in the channel list -* **`mentionbadgecolor`** (string) - background color for mention badges -* **`mentionbadgetextcolor`** (string) - color to use for number displayed on mention badges -* **`unreadcolor`** (string) - color to use for the unread indicator +| Setting | Type | Description | +|-------------------------|--------|-----------------------------------------------------| +| `linkcolor` | string | color to use for links in messages | +| `expandercolor` | string | color to use for the expander in the channel list | +| `nsfwchannelcolor` | string | color to use for NSFW channels in the channel list | +| `channelcolor` | string | color to use for SFW channels in the channel list | +| `mentionbadgecolor` | string | background color for mention badges | +| `mentionbadgetextcolor` | string | color to use for number displayed on mention badges | +| `unreadcolor` | string | color to use for the unread indicator | ### Environment variables -* **`ABADDON_NO_FC`** (Windows only) - don't use custom font config -* **`ABADDON_CONFIG`** - change path of configuration file to use. relative to cwd or can be absolute +| variable | Description | +|------------------|------------------------------------------------------------------------------| +| `ABADDON_NO_FC` | (Windows only) don't use custom font config | +| `ABADDON_CONFIG` | change path of configuration file to use. relative to cwd or can be absolute | -- cgit v1.2.3 From 5c148d19dd001abf02fc7ea9280d028f8d6cea92 Mon Sep 17 00:00:00 2001 From: FwankiL <89987389+FwankiL@users.noreply.github.com> Date: Tue, 3 Jan 2023 20:01:54 -0500 Subject: docs: added Fedora build deps (#131) * Update README.md added Fedora installation instructions --- README.md | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index 7e6fe30..07b9052 100644 --- a/README.md +++ b/README.md @@ -79,6 +79,10 @@ the result of fundamental issues with Discord's thread implementation. ```Shell $ sudo pacman -S gcc cmake gtkmm3 libcurl-gnutls lib32-sqlite lib32-openssl nlohmann-json libhandy ``` + * On Fedora Linux: + ```Shell + $ sudo dnf install g++ cmake gtkmm3.0-devel libcurl-devel sqlite-devel openssl-devel json-devel libsecret-devel libhandy-devel + ``` 2. `git clone https://github.com/uowuo/abaddon --recurse-submodules="subprojects" && cd abaddon` 3. `mkdir build && cd build` 4. `cmake ..` -- cgit v1.2.3