Amethyst - Discord Theme

💎 An elegant purple Discord theme with crystal-clear transparent UI

Zero clutter. Pure aesthetics. Stays out of your way.

⚡ Quick Install • ✨ Features • 🎨 Customize • 💬 Support

⭐ Love Amethyst? Star this repo to show your support and help others discover it!

---

🚀 Why Amethyst?

Unlike bloated themes that break with every Discord update, Amethyst is built different:

✅ Minimal & Fast - Only touches colors/backgrounds, never breaks functionality
✅ Always Updated - Fixes pushed within 24-48 hours when Discord updates
✅ Two Variants - Choose role colors or pure white text
✅ No Learning Curve - Looks premium out of the box, customizable if you want

✅ FIXED in v2.0.1: Discord's January 2026 update caused invisible gradient usernames. All issues resolved!

📸 See It In Action

Video Demo

Screen-Recording.mp4

Screenshots

✨ Features

Visual Polish:

• 🔮 Circular Server Icons with smooth hover animations
• 📜 Purple Gradient Scrollbar (main areas) + subtle gray (server list)
• 🎯 Zero Background Boxes - Clean, transparent UI throughout
• 💬 Readable Text - Normal sizes, no zoom or oversized fonts

Smart Fixes:

• 🎵 Music Player Integration - Purple progress bars without breaking layout
• 🏷️ Tag & Badge Support - No purple/black boxes on emojis or status
• ⌨️ Clear Input Icons - All buttons visible with proper contrast
• 🎨 Role Colors Preserved - Shows Discord's native color hierarchy (default variant)

Under the Hood:

• ⚡ Performance Optimized - No expensive CSS selectors
• 🔧 Minimal Overrides - Preserves Discord's native behavior
• 🔄 Quick Updates - Fixes pushed when Discord changes their UI

📦 Installation

Choose Your Variant

Variant	Best For	Download
Amethyst (Recommended)	Shows role colors (pink, blue, green) on member names	⬇️ Download
Amethyst WhiteText	Pure white names - cleaner, uniform look	⬇️ Download

Prerequisites

Choose ONE of these Discord mods:

• Vencord (Recommended - faster, more modern) OR
• BetterDiscord (Classic option)

Note: You cannot use both Vencord and BetterDiscord at the same time!

For Vencord Users

1. Download the theme file

   • Download your preferred variant from the links above

2. Open Vencord themes folder

   • Open Discord
   • Go to User Settings (gear icon)
   • Navigate to Vencord > Themes
   • Click "Open Themes Folder" button

3. Install the theme

   • Copy the downloaded .theme.css file to the themes folder
   • Go back to Discord settings
   • Enable the theme in Vencord > Themes tab

4. Refresh Discord

   • Press Ctrl+R to reload Discord and apply the theme

For BetterDiscord Users

1. Download the theme file

   • Download your preferred variant from the links above

2. Open BetterDiscord themes folder

   • Open Discord
   • Go to User Settings (gear icon)
   • Navigate to BetterDiscord > Themes
   • Click "Open Themes Folder" button

3. Install the theme

   • Copy the downloaded .theme.css file to the themes folder
   • Go back to Discord settings
   • Enable the theme in the Themes tab

4. Refresh Discord

   • Press Ctrl+R to reload Discord and apply the theme

📁 Folder Organization (Optional)

Want better server folder organization? Choose the plugin for YOUR Discord mod:

For Vencord Users

BetterFolders is built into Vencord!

1. Open Discord → User Settings
2. Go to Vencord → Plugins
3. Search for "BetterFolders"
4. Toggle it ON
5. Click the gear icon ⚙️ next to BetterFolders
6. Enable these settings:
   • ✅ Show Folder Icon → Set to "Always"
   • ✅ Sidebar → Turn ON (opens folders in a sidebar)
   • ✅ Close on Open → Turn ON (optional - auto-closes other folders)
7. Restart Discord (Ctrl+R)

Features:

• Folders show as single colored icons (not showing servers inside)
• Click folder → servers open in clean sidebar
• Much more organized than default Discord folders

For BetterDiscord Users

ServerFolders by DevilBro

1. Download TWO files from BetterDiscordAddons:

   • Library: /Library/0BDFDB.plugin.js (required for all DevilBro plugins)
   • Plugin: /Plugins/ServerFolders/ServerFolders.plugin.js

2. Install both files:

   • Open Discord → User Settings → BetterDiscord → Plugins
   • Click "Open Plugins Folder"
   • Copy both .plugin.js files into that folder

3. Enable the plugins:

   • Go back to Discord → BetterDiscord → Plugins
   • Enable BDFDB (the library)
   • Enable ServerFolders
   • Restart Discord (Ctrl+R)

Direct links:

• 0BDFDB Library (Right-click → Save As)
• ServerFolders Plugin (Right-click → Save As)

Features:

• Opens folders in separate sidebar view
• Custom folder icons and colors
• Advanced folder settings
• Right-click folders for customization options

---

Note: Both plugins enhance Discord's built-in folders. You still create folders by dragging one server icon onto another!

🎨 Customization

All colors can be customized by editing the CSS variables at the top of the theme file.

Change Purple Accent Color

Find these variables in Amethyst.theme.css (around lines 30-35):

--brand-experiment: #7C3AED !important;
--brand-500: #7C3AED !important;
--blurple-50: #7C3AED !important;
--background-accent: #7C3AED !important;

Replace #7C3AED with your preferred color!

Popular Alternative Colors

Blue:

--brand-experiment: #3B82F6 !important;
--brand-500: #3B82F6 !important;
--blurple-50: #3B82F6 !important;
--background-accent: #3B82F6 !important;

Teal:

--brand-experiment: #14B8A6 !important;
--brand-500: #14B8A6 !important;
--blurple-50: #14B8A6 !important;
--background-accent: #14B8A6 !important;

Pink:

--brand-experiment: #EC4899 !important;
--brand-500: #EC4899 !important;
--blurple-50: #EC4899 !important;
--background-accent: #EC4899 !important;

Green:

--brand-experiment: #10B981 !important;
--brand-500: #10B981 !important;
--blurple-50: #10B981 !important;
--background-accent: #10B981 !important;

Change Background Darkness

Modify these variables for lighter/darker backgrounds:

--background-primary: #1C1C28 !important;    /* Main background */
--background-secondary: #252537 !important;  /* Sidebar */
--background-tertiary: #2D2D3C !important;   /* Input boxes */

Tip: After editing, save the file and press Ctrl+R in Discord to see changes!

🎯 What This Theme Styles

All fixes use exact Discord class targeting - no aggressive overrides:

• ✅ Server Icons - Circular with smooth hover animations
• ✅ Scrollbars - Purple gradient (main), gray (server list)
• ✅ Messages - Normal size, subtle purple accent on hover
• ✅ Input Bar - Transparent buttons, visible icons, proper contrast
• ✅ Voice Controls - Transparent mute/deafen/settings buttons
• ✅ Music Player - Natural styling, shows purple progress
• ✅ Activity Panel - Transparent backgrounds (preserves sliders)
• ✅ Profile Badges - No purple boxes around badges
• ✅ Custom Status - No black boxes on text or emoji
• ✅ Server Tags - No purple boxes on server tag badges/emoji
• ✅ Buttons - Clean borders, purple brand accent
• ✅ Folders - Maintains Discord's default behavior (enhance with plugins above)

📝 What This Theme DOESN'T Do

Minimal is the goal - this theme avoids:

• ❌ Font changes (uses Discord's default)
• ❌ Layout modifications (no flexbox overrides)
• ❌ Zoom/scaling changes
• ❌ Aggressive positioning (breaks with Discord updates)
• ❌ Heavy animations or effects
• ❌ Breaking functional elements (sliders, drag-and-drop, etc.)

Why? These changes often break with Discord updates or conflict with plugins. This theme sticks to colors, backgrounds, and transparency only.

🐛 Troubleshooting

Theme Not Applying?

1. Verify mod is installed:

   • Open Discord User Settings
   • Look for "Vencord" or "BetterDiscord" section in left menu
   • If missing, reinstall Vencord/BetterDiscord

2. Make sure theme is enabled:

   • Go to Vencord/BetterDiscord → Themes
   • Toggle Amethyst.theme.css ON

3. Force refresh:

   • Press Ctrl+R in Discord
   • Theme should apply immediately

Purple Boxes Still Showing?

If you see purple/black boxes on specific elements:

1. Press Ctrl+Shift+I to open DevTools
2. Right-click the element with boxes → Inspect
3. Copy the HTML (right-click element → Copy → Copy element)
4. Open a GitHub issue with the HTML snippet

Discord's class names are hashed and sometimes change with updates. I can add fixes quickly!

Folders Not Working?

The theme doesn't control folder behavior - that's handled by Discord or plugins.

If drag-and-drop folders don't work:

• This is a Discord/plugin issue, not the theme
• Try the BetterFolders plugin (see section above)
• Some Discord installations have folders disabled

If BetterFolders plugin doesn't work:

• Make sure you're on the right mod (Vencord vs BetterDiscord)
• For BetterDiscord: Verify both 0BDFDB.plugin.js and ServerFolders.plugin.js are installed
• For Vencord: Check that BetterFolders plugin is enabled in Vencord settings
• Restart Discord completely (not just Ctrl+R)

Music Player Not Showing Purple?

The theme doesn't force music player styling - it lets Discord handle it naturally and only adds purple to the progress bar. If you don't see purple progress, Discord might have changed the class names.

Wrong Scrollbar Colors?

• Main chat area should have purple gradient scrollbar
• Server list (left sidebar) should have gray scrollbar

If reversed, Discord may have changed class names. Open an issue!

❓ FAQ

Can I use this with both Vencord AND BetterDiscord?

No - you can only use one mod at a time. Choose either Vencord (recommended) or BetterDiscord.

Will this theme break with Discord updates?

Discord themes use CSS which occasionally needs updating when Discord changes their interface. I monitor for breaks and push fixes quickly (usually within 24-48 hours).

Does this slow down Discord?

The theme is optimized for performance. If you experience lag, email luna1324001@gmail.com - performance issues are top priority.

Can I customize the purple color?

Yes! See the Customization section. Just replace #7C3AED with your preferred color in the theme file.

Is this safe to use?

Yes. Themes only change appearance (CSS). They can't access your messages, passwords, or personal data. Both Vencord and BetterDiscord are widely used and safe.

How do I uninstall?

Just disable the theme in your mod's settings, or delete the .theme.css file from your themes folder. Press Ctrl+R to refresh Discord.

Can I share/modify this theme?

Absolutely! It's MIT licensed - free to use, modify, and redistribute. No attribution required (but appreciated!).

📦 Files Included

• Amethyst.theme.css - Main version with role colors (recommended)
• Amethyst-WhiteText.theme.css - Pure white text variant
• QUICK-START.md - Fast installation guide
• CUSTOMIZATION-EXAMPLES.md - Advanced customization examples

⚠️ Known Issues

No major issues currently known. All Discord January 2026 update bugs have been fixed in v2.0.0!

• Discord class changes - Discord occasionally updates their CSS class names, which may temporarily break specific styling. Report via GitHub Issues or email luna1324001@gmail.com and fixes will be pushed within 24-48 hours.

Theme tested on Discord Stable (January 2026).

🔄 Version History

v2.0.1 "Gradient Username Fix" (Current - January 24, 2026)

• 🐛 Fixed invisible gradient usernames - Users with gradient username decorations now display correctly
• 🔧 Added :not() exclusions to preserve background-image on gradient text elements
• ✅ Theme no longer strips Discord's native gradient username styling

v2.0.0 "Compatibility Fix" (January 23, 2026)

• 🐛 Fixed invisible mutual server icons - Discord update broke inline background-image rendering
• 🐛 Fixed purple backgrounds in activity tab - Removed from badges and labels
• 🐛 Fixed purple backgrounds on server tag emojis
• 🐛 Fixed black boxes around member names
• 🎨 Two variants available - Role colors (default) and pure white text
• 🔧 Improved CSS specificity - Added :not([style*="background-image"]) exceptions to prevent future breaks
• ✅ All visual issues from Discord's January 2026 update resolved

v1.1.0 "Performance" (January 2026)

• ⚡ Major performance optimization - removed expensive CSS selectors
• ⚡ Eliminated input lag during typing
• ⚡ Improved folder opening speed
• ⚡ Smoother scrolling in member lists
• ✅ All visual features preserved
• ✅ Fixed activity badge purple circles

v1.0.0 "Amethyst" (January 2026)

• ✅ Rebranded as Amethyst - elegant purple gemstone theme
• ✅ Fixed server tag badge/emoji purple boxes
• ✅ Fixed custom status emoji black boxes
• ✅ Fixed profile badge purple boxes
• ✅ All UI elements now clean and transparent
• ✅ Maintains Discord's native behavior

v26-v30 (Development versions)

• Progressive fixes for type bar, music player, scrollbars, badges
• Removed layout overrides (caused breakage)
• Adopted minimal styling approach

v15 (Stable Backup)

• Original stable version
• Circular icons, clean activity, no zoom
• Preserved as fallback

🤝 Contributing & Support

Found a purple/black box I missed? Discord updated and broke something? Have a feature request?

Report Issues:

1. Press Ctrl+Shift+I → Inspect the element
2. Copy the HTML (Right-click → Copy → Copy element)
3. Open a GitHub issue with:
   • Screenshot of the problem
   • HTML snippet
   • Your Discord version

Contact:

• Email: luna1324001@gmail.com
• GitHub Issues: Report a bug or request a feature

I'll add fixes quickly! Usually within 24-48 hours.

� Want a Different Theme?

Have an idea for a completely different theme style (different colors, aesthetic, or concept)?

I'm open to creating new themes! If there's enough community interest in a specific theme idea, I'll consider developing it as a separate project.

How to request:

1. Open a GitHub issue or email luna1324001@gmail.com
2. Describe the theme concept (colors, style, inspiration)
3. If others are interested, they can upvote/comment on the issue

If a theme request gets enough interest, I'll work on making it happen! 🎨

�📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

TL;DR: Free to use, modify, and distribute. No attribution required, but appreciated! 🎉

🙏 Credits

• Theme: Built through iterative user feedback and refinement
• Name: Inspired by the beautiful purple amethyst gemstone 💎
• Plugins: ServerFolders by DevilBro, BetterFolders by Juby210/AutumnVN/Nuckyz
• Inspiration: Clean, minimal Discord themes from the community

---

Enjoy your elegant Amethyst Discord experience! 💜

If this theme saved you hours of tweaking, consider starring the repo!

For support or suggestions, feel free to contribute or open an issue.