Skip to content

Repository files navigation

Shellcord

A terminal-inspired Discord theme built for developers. License Stars CSS Vencord BetterDiscord

Modular customization · Catppuccin colors · Clean terminal aesthetic

Shellcord preview

Features

  • Terminal-inspired interface with TUI-style panel labels
  • Catppuccin Mocha palette and DM Mono typography
  • Rounded, softly blurred panels with focused hover accents
  • Optional ASCII titles, loaders, Spotify progress bar, and panel labels
  • Modular CSS source files for straightforward customization
  • Compatible with Vencord and BetterDiscord

Installation

Vencord

Open Settings → Themes → Online Themes and add:

https://raw.githubusercontent.com/nihitdev/shellcord/main/theme/shellcord.theme.css

BetterDiscord

  1. Download shellcord.theme.css.
  2. Move it into your BetterDiscord themes folder.
  3. Enable Shellcord from the Themes page.

Customization

Open theme/shellcord.theme.css and adjust the variables near the top of the file. You can change typography, spacing, animations, window controls, blur, panel labels, ASCII styling, and the complete color palette without editing generated CSS.

The inherited ASCII loader value remains system24 for compatibility:

body {
    --ascii-titles: on;
    --ascii-loader: system24;
    --panel-labels: on;
    --custom-spotify-bar: on;
}

Development

git clone https://github.com/nihitdev/shellcord.git
cd shellcord
npm install
npm run build

Make changes in src/ and run npm run build to regenerate build/shellcord.css. Do not edit the generated build directly.

For live desktop development, set DEV_OUTPUT_PATH in .env and run npm run dev. The browser injection workflow is documented in docs/BROWSER_DEV.md.

Project structure

src/                       Shellcord source modules
theme/shellcord.theme.css  Installable theme and public variables
build/shellcord.css        Generated, committed CSS build
scripts/theme.config.js    Build paths and source ordering

Credits

Shellcord is based on System24 by refact0r and inherits midnight. It is not affiliated with or endorsed by either project. The color palette and related assets are credited to Catppuccin.

License

Distributed under the MIT License. Preserve the upstream System24 license and attribution when redistributing this fork.

About

A shell-inspired Discord theme with modular customization, Catppuccin colors, and a clean terminal aesthetic.

Topics

Resources

Contributing

Stars

Watchers

Forks

Contributors

Languages