Skip to content

Devollox/void-presence

Repository files navigation

image

Void Presence demo Void Presence demo animated image

Void Presence – Advanced Discord Rich Presence manager with full control over your activity display.


Overview

Void Presence is an advanced Discord Rich Presence manager with two RPC Modes (Basic / Music and Youtube), customizable button pairs, text cycles, image rotation, drag‑and‑drop profile management, and easy config transfer between machines. Advanced mode intelligently detects Music and YouTube activity!


Features

  • RPC ModesBasic (lightweight) / Music and Youtube (Spotify + YouTube)
  • Custom button pairs – Create multiple button sets with labels and URLs
  • Custom update interval – Control how often activity is refreshed (in seconds)
  • Status cycles – Rotate between different status messages (details and state)
  • Image rotation – Cycle through multiple large and small Rich Presence images
  • Profiles with drag & drop – Create, reorder, and switch between presence profiles
  • Config import / export – Move your setup between machines via JSON config files
  • Real-time updates – Activity refreshes every 30 seconds automatically
  • Discord RPC integration – Uses Discord Rich Presence RPC API under the hood
  • Auto-launch (optional) – Start with the system
  • Auto-hide (optional) – Start minimized to tray
  • Minimalist UI – Dark, clean interface with real-time preview
  • System tray – Quick access while running in the background

Installation

Quick setup

  1. Click the releases button → Download ZIP - Last Releases
  2. Extract the ZIP archive
  3. Run Void Presence.exe
  4. Enter your Discord Application ID (from the Discord Developer Portal)
  5. Configure buttons, status cycles, images, and profiles
  6. Click Save to start Rich Presence

⏱️ Initial delay – On first launch, status may appear in Discord after ~25 seconds. This is normal and only happens on startup.


Configuration

Discord Application ID

  1. Open the Discord Developer Portal
  2. Create a new application
  3. Copy the Application ID from General Information
  4. Paste it into the CLIENT ID field in Void Presence

RPC Modes Explained

Mode Features CPU Spotify/YouTube Use Case
Basic Core RPC
Lightweight
0.1% None Gaming, coding, minimal
Advanced All Basic +
Music detection
YouTube activity
0.4% Full Streaming, music, YouTube

RPC Update Intervals

Recommended Settings

Use Case Interval Discord Rate Limit CPU Usage Notes
Default 30 sec Safe 0.1% Perfect balance — smooth rotation, no limits
Fast cycles 5-15 sec Safe 0.3% Good for frequent status changes
Aggressive 2 sec 60/min limit 0.8% Works but Discord may throttle
Avoid <1 sec Rate limited 2%+ Discord drops updates

Best Practices

// Your current minimum (5 sec) is perfect
setActivityInterval(sec) {
  if (sec < 5) activityIntervalMs = 5000  // Safe default
}

Recommended user presets:

  • 30s — Gaming/Streaming (default)
  • 15s — Coding sessions
  • 5s — Rapid status changes

Button pairs

  • Each pair contains two buttons with labels and URLs
  • You can create multiple pairs and reuse them across profiles
  • Buttons will appear on your Discord Rich Presence card

Status cycles

  • Add multiple status items with Details, State, Image and Button
  • Items rotate every N seconds (default: 30)
  • Great for showcasing what you are doing (gaming, coding, streaming, etc.)

Images

  • Large image – Main Rich Presence artwork
  • Small image – Badge/overlay image
  • Use Discord asset keys from your application or external URLs
  • Add several images and enable rotation for more dynamic presence

Profiles (drag & drop)

  • Create separate profiles for gaming, work, streaming, etc.
  • Reorder profiles with drag and drop to prioritize them
  • Switch between presets without rebuilding configuration

Config import / export

  • Export your current setup to a JSON config
  • Import by dropping the file onto the app or using the file picker
  • Perfect for backup or sharing setups across machines or accounts
  • Upload your profiles to the cloud and restore them on any machine using your Author ID from the Void Presence profile page: + Author ID

Presets & Community Configs

Void Presence ships with ready‑to‑use Rich Presence presets and supports importing custom configurations.

You can browse, search, and download community configs here:
+ Configs


Usage

  1. Set Client ID – Enter your Discord Application ID
  2. Set update interval – Choose how often to refresh activity (seconds)
  3. Add images – Configure large and small image rotation
  4. Add buttons – Create button pairs with labels and URLs
  5. Add status cycles – Define messages to rotate
  6. Create profiles – Combine buttons, statuses, and images into presets
  7. Use drag & drop – Reorder profiles in the list
  8. Use config import/export – Save or load JSON presets
  9. Toggle auto start – Enable/disable on system startup
  10. Toggle auto hide – Start minimized to tray
  11. Click Save – Apply all changes and start Rich Presence
  12. Click Restart Presence – Reload the current configuration
  13. Click Stop Presence – Disable Rich Presence
  14. Click Upload Current – Send the active config to the Void Presence website

Keyboard shortcuts

  • Ctrl+, – Show / hide window
  • Ctrl+R – Restart Rich Presence
  • Ctrl+Q – Quit application

Tech stack

  • Frontend – TypeScript, HTML5, CSS3
  • Backend – Electron, Node.js
  • RPCdiscord-rpc library for Discord Rich Presence

Security & data

Void Presence uploads only Rich Presence configuration data when you use cloud features or share configs on the website.

What can be stored in the cloud:

  • Config data – button pairs, status cycles, image cycles and related settings (configData, buttonPairs, cycles, imageCycles)
  • Metadata – config title, description, upload timestamp, download counter (title, description, uploadedAt, downloads)
  • Author name – your display name or handle shown as the config author (author, for example Devollox)

What is not stored:

  • No Discord tokens, passwords or OAuth keys
  • No personal messages or Discord account data
  • No system files or arbitrary local data

Configs are used only to render Rich Presence and to let you share presets between machines or with other users through the Void Presence website.


Author

Made with ❤️ by Devollox

выфвфы

Void Presence – Control your Discord presence. Own your story.

About

Advanced Discord Rich Presence manager with Basic/Advanced RPC Modes (Music+YouTube detection), customizable profiles, buttons, status cycles, images, and configurable update intervals.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors