{"id":34795304,"url":"https://github.com/devollox/void-presence","last_synced_at":"2026-04-05T08:01:14.624Z","repository":{"id":330750522,"uuid":"1122490486","full_name":"Devollox/void-presence","owner":"Devollox","description":"Advanced Discord Rich Presence manager with Basic/Advanced RPC Modes (Music+YouTube detection), customizable profiles, buttons, status cycles, images, and configurable update intervals.","archived":false,"fork":false,"pushed_at":"2026-04-02T17:00:47.000Z","size":922,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T03:57:50.273Z","etag":null,"topics":["customizable","discord","discord-rich-presence","discord-rpc","electron","rich-presence","rpc"],"latest_commit_sha":null,"homepage":"https://voidpresence.site","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Devollox.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-24T21:11:23.000Z","updated_at":"2026-04-02T17:00:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Devollox/void-presence","commit_stats":null,"previous_names":["devollox/void-presence"],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/Devollox/void-presence","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Devollox%2Fvoid-presence","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Devollox%2Fvoid-presence/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Devollox%2Fvoid-presence/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Devollox%2Fvoid-presence/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Devollox","download_url":"https://codeload.github.com/Devollox/void-presence/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Devollox%2Fvoid-presence/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31428645,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T02:22:46.605Z","status":"ssl_error","status_checked_at":"2026-04-05T02:22:33.263Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["customizable","discord","discord-rich-presence","discord-rpc","electron","rich-presence","rpc"],"created_at":"2025-12-25T10:42:15.059Z","updated_at":"2026-04-05T08:01:14.601Z","avatar_url":"https://github.com/Devollox.png","language":"TypeScript","readme":"\u003ch1 align=\"center\"\u003e\n  \u003ca href=\"https://www.voidpresence.site\"\u003eVoid Presence\u003c/a\u003e\n\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003e\n  \u003ca href=\"http://voidpresence.site/void\"\u003eClick -\u003e Demo\u003c/a\u003e\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n \u003cimg width=\"1920\" height=\"1031\" alt=\"image\" src=\"https://github.com/user-attachments/assets/57e15016-71b1-44cc-9e39-ed1244990d15\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"450\" height=\"493\" alt=\"Void Presence demo\" src=\"https://github.com/user-attachments/assets/b290bd68-2a95-4ac1-844a-f5f446136394\" /\u003e\n  \u003cimg width=\"450\" height=\"493\" alt=\"Void Presence demo animated\" src=\"https://media3.giphy.com/media/v1.Y2lkPTc5MGI3NjExeXAxaWtpM2hxeW96MHJhNWVuZzN4MG4zdGRtZ2QwbnBtcDc1ODFmOCZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/Ks5t457f2MSwsYWjPV/giphy.gif\" /\u003e\n  \u003cimg width=\"314\" height=\"166\" alt=\"image\" src=\"https://github.com/user-attachments/assets/0b33c5b4-a2d6-411a-b895-e4d309b51c8a\" /\u003e\n\u003c/p\u003e\n\n\u003e **Void Presence** – Advanced Discord Rich Presence manager with full control over your activity display.\n\n---\n\n## Overview\n\nVoid 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!\n\n---\n\n## Features\n- **RPC Modes** – `Basic` (lightweight) / `Music and Youtube` (**Spotify + YouTube**)\n- **Custom button pairs** – Create multiple button sets with labels and URLs  \n- **Custom update interval** – Control how often activity is refreshed (in seconds)  \n- **Status cycles** – Rotate between different status messages (`details` and `state`)  \n- **Image rotation** – Cycle through multiple large and small Rich Presence images  \n- **Profiles with drag \u0026 drop** – Create, reorder, and switch between presence profiles  \n- **Config import / export** – Move your setup between machines via JSON config files  \n- **Real-time updates** – Activity refreshes every 30 seconds automatically  \n- **Discord RPC integration** – Uses Discord Rich Presence RPC API under the hood\n- **Auto-launch (optional)** – Start with the system  \n- **Auto-hide (optional)** – Start minimized to tray  \n- **Minimalist UI** – Dark, clean interface with real-time preview  \n- **System tray** – Quick access while running in the background  \n\n---\n\n## Installation\n\n### Quick setup\n\n1. Click the **releases** button → **Download ZIP** - [Last Releases](https://github.com/Devollox/void-presence/releases)\n2. Extract the ZIP archive  \n3. Run `Void Presence.exe`  \n4. Enter your Discord **Application ID** (from the [Discord Developer Portal](https://discord.com/developers/applications))  \n5. Configure buttons, status cycles, images, and profiles  \n6. Click **Save** to start Rich Presence\n\n\u003e **⏱️ Initial delay** – On first launch, status may appear in Discord after ~25 seconds. This is normal and only happens on startup.  \n\n---\n\n## Configuration\n\n### Discord Application ID\n\n1. Open the [Discord Developer Portal](https://discord.com/developers/applications)  \n2. Create a new application  \n3. Copy the **Application ID** from **General Information**  \n4. Paste it into the `CLIENT ID` field in Void Presence\n\n##  RPC Modes Explained\n\n| Mode | Features | CPU | Spotify/YouTube | Use Case |\n|------|----------|-----|-----------------|----------|\n| **Basic** |  Core RPC\u003cbr\u003e Lightweight | **0.1%** |  None | Gaming, coding, minimal |\n| **Advanced** |  All Basic +\u003cbr\u003e **Music detection**\u003cbr\u003e **YouTube activity** | **0.4%** | **Full** | Streaming, music, YouTube |\n\n\n## RPC Update Intervals\n\n### Recommended Settings\n\n| Use Case | Interval | Discord Rate Limit | CPU Usage | Notes |\n|----------|----------|-------------------|-----------|-------|\n| **Default** | **30 sec** | Safe | 0.1% | **Perfect balance** — smooth rotation, no limits |\n| **Fast cycles** | **5-15 sec** | Safe | 0.3% | Good for frequent status changes |\n| **Aggressive** | **2 sec** | 60/min limit | 0.8% | Works but Discord may throttle |\n| **Avoid** | **\u003c1 sec** | Rate limited | 2%+ | Discord drops updates |\n\n### Best Practices\n\n```typescript\n// Your current minimum (5 sec) is perfect\nsetActivityInterval(sec) {\n  if (sec \u003c 5) activityIntervalMs = 5000  // Safe default\n}\n```\n\nRecommended user presets:\n- 30s — Gaming/Streaming (default)\n- 15s — Coding sessions  \n- 5s  — Rapid status changes\n\n### Button pairs\n\n- Each pair contains two buttons with labels and URLs  \n- You can create multiple pairs and reuse them across profiles  \n- Buttons will appear on your Discord Rich Presence card\n\n### Status cycles\n\n- Add multiple status items with `Details`, `State`, `Image` and `Button`\n- Items rotate every N seconds (default: 30)  \n- Great for showcasing what you are doing (gaming, coding, streaming, etc.)\n\n### Images\n\n- **Large image** – Main Rich Presence artwork  \n- **Small image** – Badge/overlay image  \n- Use Discord asset keys from your application or external URLs  \n- Add several images and enable rotation for more dynamic presence\n\n### Profiles (drag \u0026 drop)\n\n- Create separate profiles for gaming, work, streaming, etc.  \n- Reorder profiles with drag and drop to prioritize them  \n- Switch between presets without rebuilding configuration\n\n### Config import / export\n\n- Export your current setup to a JSON config  \n- Import by dropping the file onto the app or using the file picker  \n- Perfect for backup or sharing setups across machines or accounts  \n- Upload your profiles to the cloud and restore them on any machine using your **Author ID** from the Void Presence profile page: [+ Author ID](https://www.voidpresence.site/profile)  \n\n---\n\n## Presets \u0026 Community Configs\n\nVoid Presence ships with ready‑to‑use Rich Presence presets and supports importing custom configurations.\n\nYou can **browse, search, and download community configs here**:  \n[+ Configs](https://www.voidpresence.site/configs)\n\n---\n\n## Usage\n\n1. Set **Client ID** – Enter your Discord Application ID  \n2. Set **update interval** – Choose how often to refresh activity (seconds)  \n3. Add **images** – Configure large and small image rotation  \n4. Add **buttons** – Create button pairs with labels and URLs  \n5. Add **status cycles** – Define messages to rotate  \n6. Create **profiles** – Combine buttons, statuses, and images into presets  \n7. Use **drag \u0026 drop** – Reorder profiles in the list  \n8. Use **config import/export** – Save or load JSON presets  \n9. Toggle **auto start** – Enable/disable on system startup  \n10. Toggle **auto hide** – Start minimized to tray  \n11. Click **Save** – Apply all changes and start Rich Presence  \n12. Click **Restart Presence** – Reload the current configuration  \n13. Click **Stop Presence** – Disable Rich Presence\n14. Click **Upload Current** – Send the active config to the Void Presence website\n\n---\n\n## Keyboard shortcuts\n\n- `Ctrl+,` – Show / hide window  \n- `Ctrl+R` – Restart Rich Presence  \n- `Ctrl+Q` – Quit application  \n\n---\n\n## Tech stack\n\n- **Frontend** – TypeScript, HTML5, CSS3  \n- **Backend** – Electron, Node.js  \n- **RPC** – `discord-rpc` library for Discord Rich Presence\n\n---\n\n## Security \u0026 data\n\nVoid Presence uploads only **Rich Presence configuration data** when you use cloud features or share configs on the website.\n\nWhat can be stored in the cloud:\n\n- **Config data** – button pairs, status cycles, image cycles and related settings (`configData`, `buttonPairs`, `cycles`, `imageCycles`)  \n- **Metadata** – config title, description, upload timestamp, download counter (`title`, `description`, `uploadedAt`, `downloads`)  \n- **Author name** – your display name or handle shown as the config author (`author`, for example `Devollox`)\n\nWhat is **not** stored:\n\n- No Discord tokens, passwords or OAuth keys  \n- No personal messages or Discord account data  \n- No system files or arbitrary local data\n\nConfigs are used only to render Rich Presence and to let you share presets between machines or with other users through the Void Presence website.\n\n---\n\n## Author\n\nMade with ❤️ by [Devollox](https://github.com/Devollox)\n\n\u003cp align=\"left\"\u003e\n  \u003cimg width=\"128\" height=\"128\" alt=\"выфвфы\" src=\"https://github.com/user-attachments/assets/f5c3c406-552b-412e-a2a9-3ff0fdddf400\" /\u003e\n\u003c/p\u003e\n\n**Void Presence** – Control your Discord presence. Own your story.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevollox%2Fvoid-presence","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevollox%2Fvoid-presence","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevollox%2Fvoid-presence/lists"}