Skip to content

Allows you to hide certain servers/folders in your server list with right-click option and manage mentions handling with various settings

Notifications You must be signed in to change notification settings

TetraSsky/CleanCord

Repository files navigation

CleanCord - Server & Folder Hider for Vencord

Banner

CleanCord is a Vencord plugin that allows you to hide specific servers and folders from your Discord server list, for various use cases 🔎 !

Features

  • Hide individual servers with a right-click
  • Hide entire folders with a right-click
  • Option to only hide servers when in Streamer Mode
  • Option to also hide servers when using Quick-Switcher (CTRL+K)
  • Option to Manage Discord behaviour for incoming mentions from hidden servers/folders (Both in real-time & on startup)
  • Manage hidden servers/folders through Vencord plugin settings

Installation

Prerequiries : git / NodeJS / pnpm

  • Open a CMD window, you will need a clone of Vencord's Repository, command : git clone https://github.com/Vendicated/Vencord
  • Navigate to the path where you cloned the repository (Ex : "cd C:\Documents\Vencord") then type : pnpm install --frozen-lockfile
  • Inside the 'Vencord' Folder, navigate to ".\src\" and create a new folder called "userplugins"
  • Then inside that new 'userplugin' Folder, navigate to it with your (hopefully, still opened) CMD window (Ex : "cd .\src\userplugins\") and type, command : git clone https://github.com/TetraSsky/CleanCord/
  • Then command : pnpm build
  • And lastly command : pnpm inject (Select your Discord path (Stable / Canary))

Usage

Hiding Servers/Folders

  1. Right-click on any server or folder in your server list
  2. Select "Hide Server" or "Hide Folder" from the context menu
  3. The server/folder will immediately disappear from your view

Managing Hidden Items

  1. Go to Vencord Settings > Plugins > CleanCord (Or right-click --> "Manage CleanCord's settings")
  2. You'll see two sections:
    • Hidden Servers: Lists all currently hidden servers
    • Hidden Folders: Lists all currently hidden folders
  3. Toggle the checkboxes to show/hide items
  4. Use "Unhide All" to reset everything

Streamer Mode Integration

Enable the "Only hide in Streamer Mode" option to:

  • Keep servers/folders visible normally
  • Automatically hide them when Streamer Mode is active
  • Automatically handle notifications & mentions when Streamer Mode is active

Options

Option Description Default Clearing Type
Show Options Displays the hide/unhide options in right-click menus Enabled -
Only Hide in Streamer Mode Servers/folders will only be hidden when Streamer Mode is active Disabled -
Hide In Quick Switcher Also hide servers from the quick switcher (Ctrl+K) Disabled -
Suppression Mode Default - Keep initial Discord behaviour for notifications / Silent - Block all notifications in real-time from hidden servers/folders (Resets on startup) Silent Clears in Real-Time
Auto Clear Mentions Automatically clear all unread badges from hidden servers/folders on startup (Recommended to use with Suppression Mode set to 'Silent') Disabled Clears on Startup
Hidden Servers Manage your list of hidden servers - -
Hidden Folders Manage your list of hidden folders - -

FAQ

❓: Do hidden servers still show notifications?

  • No, hidden servers won't display unread messages, mention counts or play notifications sounds. (Only when Suppresion Mode is set to Silent & (Preferably) Auto Clear Mentions is enabled)

❓: Can I still access hidden servers?

  • Yes, you can still access them through Quick Switcher (Ctrl+K), joining one of your friends' activity, etc... or by unhiding them in settings.

❓: Does this plugin breaks interaction with hidden servers?

  • No, people from any hidden server can still interact with you and vise versa. The "icons" Discord displays in the server listing are only hidden with Custom CSS injection.

❓ : Will people know I'm using CleanCord?

  • No, this is purely a visual change on your client. Moreover, there is a setting to completely hide CleanCord's right-click options! (Same goes whilst streaming, by enabling the option, CleanCord will silently hide your hidden elements the moment Streamer Mode is on)

❓: Will my hidden elements stay hidden after restarting Discord?

  • Yes, your preferences are saved between sessions thanks to Vencord!

Screenshots

Context menu Settings panel
Streamer mode example Streamer mode example 2
Hidden elements showcase

Support

If you encounter any issues or have feature requests (This will entirely depend of my free time. Be aware.): Open an issue

Credits

This plugin is built for and requires Vencord, a Discord client mod! Big thanks to them ❤️❤️❤️!

Star History

Star History Chart

License

MIT License - See LICENSE for details.

About

Allows you to hide certain servers/folders in your server list with right-click option and manage mentions handling with various settings

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published