Add toggle_afk command

Add afk sign
Add global name to show_reactions
Add warning about third party forks

Author: sparklost

README.md

@@ -369,7 +369,8 @@ Open link in browser - `Alt+O`
 This mode entirely replaces curses with pygame-ce GUI library. This means Endcord runs in its own window, not in terminal, but UI remains terminal-like.  
 Tray icon will also be enabled, so closing window will only minimize it to tray.  
 Keybinding remain the same, but all codes are like on Linux, so old keybinding codes may not work on Windows.  
-If using external editor, use some with graphical interface. TUI editors will not work, as this is no longer in terminal.  
+If using external editor, use editor with graphical interface. TUI editors will not work, as this is no longer in terminal.  
+Also, endcord built-in media player will not work because its standalone TUI thats not using curses. All meda will be opened in native player.  
 Building with nuitka on python >=3.13 will create executable that segfaults! Building with pyinstaller is not recommended because it generates huge binary.  
 You can toggle experimental mode bu running: `uv run build.py --experimental`.  
 Then run endcord from source: `uv run main.py`.  
@@ -435,6 +436,7 @@ Never tested on macOS. Feedback is welcome.
 > **Use endcord at your own risk!**
 > For more info see [FAQ](#FAQ).
 
+Third party endcord forks may add features that can lead to account ban, or contain malicious code, cause instability, especially if they include LLM generated/modified code.
 
 ## Building
 To see all build script options, run: `uv run build.py -h`.  

commands.md

@@ -97,6 +97,8 @@
     Set custom status emoji.
 - `custom_status_remove`  
     Remove custom status.
+- `toggle_afk`  
+    Toggle afk state. If afk, mobile devices will receive notifications.
 - `block *ignore <@[user_id]>`  
     Block user. `ignore` is optional.
 - `unblock *ignore <@[user_id]>`  

endcord/app.py

@@ -584,6 +584,7 @@ def reset(self, online=False):
                 "custom_status": None,
                 "custom_status_emoji": None,
                 "activities": [],
+                "afk": False,
                 "client_state": "OFFLINE",
             }
         for num, _ in enumerate(self.channel_cache):
@@ -623,6 +624,7 @@ def reconnect(self):
             custom_status=self.my_status["custom_status"],
             custom_status_emoji=self.my_status["custom_status_emoji"],
             activities=self.my_activities,
+            afk=self.my_status["afk"],
         )
 
         new_messages = self.get_messages_with_members()
@@ -3301,6 +3303,7 @@ def execute_command(self, cmd_type, cmd_args, cmd_text, chat_sel, tree_sel):
                     custom_status=self.my_status["custom_status"],
                     custom_status_emoji=self.my_status["custom_status_emoji"],
                     activities=self.my_activities,
+                    afk=self.my_status["afk"],
                 )
 
         elif cmd_type == 45:   # BLOCK
@@ -3491,6 +3494,17 @@ def execute_command(self, cmd_type, cmd_args, cmd_text, chat_sel, tree_sel):
 
         # 64 - COPY_LINK is handled together with 5 - OPEN_LINK
 
+        elif cmd_type == 65:   # TOGGLE_AFK
+            self.my_status["afk"] = not self.my_status["afk"]
+            self.gateway.update_presence(
+                self.my_status["status"],
+                custom_status=self.my_status["custom_status"],
+                custom_status_emoji=self.my_status["custom_status_emoji"],
+                activities=self.my_activities,
+                afk=self.my_status["afk"],
+            )
+            self.update_status_line()
+
         elif cmd_type == 66 and self.fun:   # 666
             self.fun = 1 if self.fun == 2 else 2
             self.tui.set_fun(self.fun)
@@ -4379,6 +4393,7 @@ def set_status(self, status):
                 custom_status=self.my_status["custom_status"],
                 custom_status_emoji=self.my_status["custom_status_emoji"],
                 activities=self.my_activities,
+                afk=self.my_status["afk"],
             )
             if self.my_status["custom_status_emoji"]:
                 custom_status_emoji_name = self.my_status["custom_status_emoji"]["name"]
@@ -7023,6 +7038,7 @@ def main(self):
             custom_status=self.my_status["custom_status"],
             custom_status_emoji=self.my_status["custom_status_emoji"],
             activities=self.my_activities,
+            afk=self.my_status["afk"],
         )
 
         # start input and sender threads
@@ -7184,6 +7200,7 @@ def main(self):
                         custom_status=self.my_status["custom_status"],
                         custom_status_emoji=self.my_status["custom_status_emoji"],
                         activities=self.my_activities,
+                        afk=self.my_status["afk"],
                     )
 
             # send new detectable games activities
@@ -7199,6 +7216,7 @@ def main(self):
                         custom_status=self.my_status["custom_status"],
                         custom_status_emoji=self.my_status["custom_status_emoji"],
                         activities=self.my_activities,
+                        afk=self.my_status["afk"],
                     )
 
             # remove expired typing
@@ -7309,6 +7327,7 @@ def main(self):
                     custom_status=self.my_status["custom_status"],
                     custom_status_emoji=self.my_status["custom_status_emoji"],
                     activities=self.my_activities,
+                    afk=self.my_status["afk"],
                 )
 
             # check changes in presences and update tree

endcord/assist_data.py

@@ -54,6 +54,7 @@
     ("custom_status [string] - set custom status text", "custom_status"),
     ("custom_status_emoji [emoji] - set custom status emoji", "custom_status_emoji"),
     ("custom_status_remove - remove custom status", "custom_status_remove"),
+    ("toggle_afk - toggle afk state; if afk, mobile devices will receive notifications", "toggle_afk"),
     ("block *ignore <@[user_id]> - block/ignore user", "block"),
     ("unblock *ignore <@[user_id]> - unblock/unignore user", "unblock"),
     ("toggle_blocked_messages - toggle showing messages from blocked users in chat", "toggle_blocked_messages"),

endcord/defaults.py

@@ -85,7 +85,7 @@
     "format_interaction": "                       ╭──⤙ %global_name used [%command]",
     "format_one_reaction": "%count:%reaction",
     "format_timestamp": "%H:%M",
-    "format_status_line_l": " %global_name (%username) - %status  %unreads %action %typing",
+    "format_status_line_l": " %global_name (%username) - %status %afk %unreads %action %typing",
     "format_status_line_r": "%slowmode",
     "format_title_line_l": " %server: %channel",
     "format_title_line_r": "%tabs",

endcord/discord.py

@@ -442,6 +442,7 @@ def get_reactions(self, channel_id, message_id, reaction):
                 reaction.append({
                     "id": user["id"],
                     "username": user["username"],
+                    "global_name": user["global_name"],
                 })
             return reaction
         logger.error(f"Failed to fetch reaction details: {reaction}. Response code: {response.status}")

endcord/formatter.py

@@ -1439,6 +1439,7 @@ def generate_status_line(my_user_data, my_status, unseen, typing, active_channel
         %task   # currently running long task
         %tabs
         %slowmode   # 'slowmode {time}'
+        %afk   # '[AFK]'
     Possible options for format_rich:
         %type
         %name
@@ -1591,6 +1592,7 @@ def generate_status_line(my_user_data, my_status, unseen, typing, active_channel
         .replace("%task", task)
         .replace("%tabs", tabs)
         .replace("%slowmode", slowmode)
+        .replace("%afk", "[AFK]" if my_status["afk"] else "")
     )
 
     status_line_format = []
@@ -2113,7 +2115,7 @@ def generate_extra_window_reactions(reaction, details, max_len):
     title_line = f"Users who reacted {reaction["emoji"]}: "
     body = []
     for user in details:
-        body.append(user["username"][:max_len])
+        body.append(f"{user["global_name"]} ({user["username"]})"[:max_len])
     return title_line[:max_len], body
 
 

endcord/parser.py

@@ -847,6 +847,9 @@ def command_string(text):
         except (IndexError, ValueError):
             pass
 
+    # 65 - TOGGLE_AFK
+    elif text_lower.startswith("toggle_afk"):
+        cmd_type = 65
 
     # 66 - 666
     elif text_lower == "666":