first commit

.github/workflows/build.yaml

@@ -0,0 +1,27 @@
+name: build
+on: [push]
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest, macos-13]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: stable
+
+      - name: Build
+        run: go build -ldflags "-s -w" .
+
+      - uses: actions/upload-artifact@v4
+        if: ${{ github.event_name == 'push' && github.ref == format('refs/heads/{0}', github.event.repository.default_branch) }}
+        with:
+          name: clicord_${{ runner.os }}_${{ runner.arch }}
+          path: |
+            clicord
+            clicord.exe

.gitignore

@@ -0,0 +1,4 @@
+clicord*
+
+# Visual Studio Code
+.vscode/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 ayn2op
+
+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.

README.md

@@ -0,0 +1,111 @@
+# clicord
+
+A Discord terminal client. Heavily work-in-progress, expect breaking changes.
+
+## Important Disclaimer
+
+> [!CAUTION]
+> Automated user accounts or "self-bots" are against Discord's Terms of Service. I am not
+> responsible for any loss caused by using "self-bots" or clicord. This client is against the Terms
+> of Service and makes little effort in hiding that it is a custom client, for example by not
+> sending typing indicators or other data that the regular Discord client does.
+
+## Installation
+
+### Building from source
+
+```bash
+git clone https://github.com/sinjs/clicord.git
+cd clicord
+go build .
+```
+
+### Linux clipboard support
+
+- `xclip` or `xsel` for X11 (`apt install xclip`)
+- `wl-clipboard` for Wayland (`apt install wl-clipboard`)
+
+## Usage
+
+1. Run the `clicord` executable.
+
+   > [!WARNING]  
+   > It is safer to log in using an authentication token instead of using the UI, since Discord
+   > monitors their authentication endpoints closely and thus increases your ban risk.
+   >
+   > Instead, to log in using a token, provide the `token` command-line flag to the executable
+   > (eg: `--token "MTI2NDU5Nzk0NTY4OTU3NTU5MQ.VGVTdA.Z28-XdheSB-HVwaWQgcGV-29uCg"`). The token is
+   > stored in the default keyring.
+
+2. Enter your email and password (and 2fa code if required) and click on the "Login" button to
+   continue.
+
+## Configuration
+
+The configuration file allows you to configure and customize the behavior, keybindings, and theme of
+the application. The file is not created automatically, it uses the default config embedded into the
+application. To configure clicord, create the config file at one of these locations:
+
+- Linux: `$XDG_CONFIG_HOME/clicord/config.toml` or `$HOME/.config/clicord/config.toml`
+- MacOS: `$HOME/Library/Application Support/clicord/config.toml`
+- Windows: `%AppData%/clicord/config.toml`
+
+```toml
+mouse = true # Allows mouse usage
+
+timestamps = true # If enabled, message timestamps will be displayed
+timestamps_before_author = true # If enabled, timestamps will be displayed before the author name instead of directly after it
+timestamps_format = "3:04PM" # The timestamp format should be one of these values: https://pkg.go.dev/time#pkg-constants
+
+# These settings are used to emulate a different Discord client. See https://docs.discord.sex/reference#example-client-properties-(web) for example values for different platforms
+user_agent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.3"
+os = "Windows"
+browser = "Chrome"
+device = ""
+
+messages_limit = 50 # The amount of messages to fetch in one channel
+editor = "default" # Any executable for an editor, for example `nvim`. By default it uses the $EDITOR environment variable, or if not found, `vi`
+
+# Keybindings: These keybinds are equivalent to the result of https://pkg.go.dev/github.com/gdamore/tcell#EventKey.Name
+[keys]
+focus_guilds_tree = "Ctrl+G"
+focus_messages_text = "Ctrl+T"
+focus_message_input = "Ctrl+P"
+toggle_guild_tree = "Ctrl+B"
+select_previous = "Rune[k]"
+select_next = "Rune[j]"
+select_first = "Rune[g]"
+select_last = "Rune[G]"
+
+[keys.guilds_tree]
+select_current = "Enter"
+
+[keys.messages_text]
+select_reply = "Rune[s]"
+reply = "Rune[r]"
+reply_mention = "Rune[R]"
+delete = "Rune[d]"
+yank = "Rune[y]"
+open = "Rune[o]"
+
+[keys.message_input]
+send = "Enter"
+editor = "Ctrl+E"
+cancel = "Esc"
+
+# Themes can change the visuals of the client
+[theme]
+border = true
+border_color = "default"
+border_padding = [0, 0, 1, 1]
+title_color = "default"
+background_color = "default"
+
+[theme.guilds_tree]
+auto_expand_folders = true
+graphics = true
+
+[theme.messages_text]
+author_color = "pink"
+reply_indicator = "╭ "
+```