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 🔎 !

Bookmarks

Features
Installation (Desktop)
Installation (Web)
Usage
Options
FAQ
Screenshots
Support
Credits
Star History
License

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 (Desktop Version)

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 and be sure to enter the 'Vencord' folder (Ex : "cd C:\Documents\Vencord") then type : pnpm install --frozen-lockfile
Now inside the 'Vencord' Folder, navigate to "cd .\src\" and type : "md userplugins"
Navigate to "cd .\userplugins\", and clone CleanCord within : git clone https://github.com/TetraSsky/CleanCord/
Then build : pnpm build
And lastly inject : pnpm inject (Select your Discord path (Stable / Canary))

You're now ready to use CleanCord (be sure to enable it in Vencord's plugin settings) !

Installation (Web Version)

⚠️ Be sure to have completed all of the steps above ⚠️

You can however exclude both last commands : pnpm build & pnpm inject, since they're not needed for the web version

PS : If you have previously installed the official Vencord extension, you might want to disable/uninstall it to avoid conflicts

You will need to build as a web browser extension with : pnpm buildWeb
This will generate a new folder in the main Vencord folder, path : 'Vencord\dist'
Head on your web browser and open "chrome://extensions" (This can vary depending on your browser)
Enable "Developer Mode" (if available/needed)
Click on "Load Unpacked" and select the "dist/chromium-unpacked" folder for chromium based browsers or "dist/firefox-unpacked" for Firefox

You're now ready to use CleanCord, on your browser (same, be sure to enable it in Vencord's plugin settings) !

Usage

Hiding Servers/Folders

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

Managing Hidden Items

Go to Vencord Settings > Plugins > CleanCord (Or right-click --> "Manage CleanCord's settings")
You'll see two sections:
- Hidden Servers: Lists all currently hidden servers
- Hidden Folders: Lists all currently hidden folders
Toggle the checkboxes to show/hide items
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 <ins>Silent</ins> & (Preferably) Auto Clear Mentions is <ins>enabled</ins>)

❓: 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

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

License

MIT License - See LICENSE for details.

CleanCord

Install / Use

README