{"id":28197562,"url":"https://github.com/utkarshthedev/webpresence","last_synced_at":"2026-02-27T20:37:50.227Z","repository":{"id":292259205,"uuid":"980312934","full_name":"UtkarshTheDev/WebPresence","owner":"UtkarshTheDev","description":"Web Presence is a lightweight browser extension that displays your current web browsing activity in Discord through Rich Presence. Show your friends what websites you're exploring in real-time with an elegant, customizable interface.","archived":false,"fork":false,"pushed_at":"2025-06-14T20:28:37.000Z","size":35588,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-19T00:29:53.511Z","etag":null,"topics":["chrome-extension","cli","discord","firefox-extension","nodejs","npm-package","opensource","presence","typescript","web"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/UtkarshTheDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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-05-08T23:38:48.000Z","updated_at":"2025-06-14T20:28:41.000Z","dependencies_parsed_at":"2025-10-10T14:41:16.106Z","dependency_job_id":null,"html_url":"https://github.com/UtkarshTheDev/WebPresence","commit_stats":null,"previous_names":["utkarshthedev/webpresence"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/UtkarshTheDev/WebPresence","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UtkarshTheDev%2FWebPresence","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UtkarshTheDev%2FWebPresence/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UtkarshTheDev%2FWebPresence/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UtkarshTheDev%2FWebPresence/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UtkarshTheDev","download_url":"https://codeload.github.com/UtkarshTheDev/WebPresence/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UtkarshTheDev%2FWebPresence/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29912397,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"ssl_error","status_checked_at":"2026-02-27T19:37:41.463Z","response_time":57,"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":["chrome-extension","cli","discord","firefox-extension","nodejs","npm-package","opensource","presence","typescript","web"],"created_at":"2025-05-16T17:14:51.232Z","updated_at":"2026-02-27T20:37:50.205Z","avatar_url":"https://github.com/UtkarshTheDev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Web Presence\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"client/chrome/icons/icon128.png\" alt=\"Web Presence Logo\" width=\"100\"\u003e\n\n  \u003ch2\u003eShare your browsing activity on Discord\u003c/h2\u003e\n\n  \u003cp align=\"center\"\u003e\n    \u003cb\u003eWeb Presence shows your friends what websites you're browsing in real-time through Discord Rich Presence.\u003c/b\u003e\u003cbr\u003e\n    It's easy to set up and works with most popular websites!\n  \u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n    \u003ca href=\"#quick-install-guide\"\u003eQuick Install\u003c/a\u003e •\n    \u003ca href=\"#need-help\"\u003eDocumentation\u003c/a\u003e •\n    \u003ca href=\"#for-developers\"\u003eFor Developers\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cimg src=\"screenshots/discord_profile_example.png\" alt=\"Discord Profile Example\" width=\"500\" style=\"border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1);\"\u003e\n\u003c/div\u003e\n\n## What is Web Presence?\n\nWeb Presence is a simple tool that shows your current website in your Discord profile. When you browse websites like YouTube, GitHub, or Twitter, your Discord profile will display what you're doing with custom icons for each site.\n\n\u003ctable border=\"0\" cellspacing=\"0\" cellpadding=\"0\" style=\"border: none; width: 100%;\"\u003e\n  \u003ctr style=\"border: none;\"\u003e\n    \u003ctd style=\"border: none; padding: 10px; vertical-align: middle;\"\u003e\n      \u003ch3\u003e✨ Key Benefits\u003c/h3\u003e\n      \u003cul\u003e\n        \u003cli\u003eShow off what content you're enjoying\u003c/li\u003e\n        \u003cli\u003eLet friends know what you're working on\u003c/li\u003e\n        \u003cli\u003eDiscover shared interests with others\u003c/li\u003e\n        \u003cli\u003eExpress yourself through your browsing habits\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/td\u003e\n    \u003ctd style=\"border: none; padding: 10px; vertical-align: middle;\"\u003e\n      \u003ch3\u003e🔐 Privacy First\u003c/h3\u003e\n      \u003cul\u003e\n        \u003cli\u003eFull control over what sites are shared\u003c/li\u003e\n        \u003cli\u003eEasy to toggle on/off with one click\u003c/li\u003e\n        \u003cli\u003eBlacklist specific domains you want to keep private\u003c/li\u003e\n        \u003cli\u003eNo data collection or tracking\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Features\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable border=\"0\" cellspacing=\"0\" cellpadding=\"0\" style=\"border: none;\"\u003e\n    \u003ctr style=\"border: none;\"\u003e\n      \u003ctd align=\"center\" width=\"50%\" style=\"border: none; padding: 10px;\"\u003e\n        \u003cdiv style=\"padding: 15px; height: 100%;\"\u003e\n          \u003ch3\u003e🌐 Shows your current website\u003c/h3\u003e\n          \u003cp\u003eYour Discord profile displays the website you're currently browsing with elapsed time\u003c/p\u003e\n          \u003cimg src=\"screenshots/showcase/custom.png\" alt=\"Current Website Display\" width=\"90%\"\u003e\n        \u003c/div\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"50%\" style=\"border: none; padding: 10px;\"\u003e\n        \u003cdiv style=\"padding: 15px; height: 100%;\"\u003e\n          \u003ch3\u003e🎮 Custom icons for popular sites\u003c/h3\u003e\n          \u003cp\u003eUnique icons for YouTube, GitHub, Twitter, and 100+ popular websites\u003c/p\u003e\n          \u003cimg src=\"screenshots/custom_icons.png\" alt=\"Custom Website Icons\" width=\"90%\"\u003e\n        \u003c/div\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr style=\"border: none;\"\u003e\n      \u003ctd align=\"center\" width=\"50%\" style=\"border: none; padding: 10px;\"\u003e\n        \u003cdiv style=\"padding: 15px; height: 100%;\"\u003e\n          \u003ch3\u003e🔒 Privacy controls\u003c/h3\u003e\n          \u003cp\u003eEasily turn presence on/off or disable for specific sites\u003c/p\u003e\n          \u003cimg src=\"screenshots/privacy_controls.png\" alt=\"Privacy Controls\" width=\"90%\"\u003e\n        \u003c/div\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"50%\" style=\"border: none; padding: 10px;\"\u003e\n        \u003cdiv style=\"padding: 15px; height: 100%;\"\u003e\n          \u003ch3\u003e🧩 Browser extension\u003c/h3\u003e\n          \u003cp\u003eSimple browser extension for Chrome and Firefox\u003c/p\u003e\n          \u003cimg src=\"screenshots/browser_extension.png\" alt=\"Browser Extension\" width=\"90%\"\u003e\n        \u003c/div\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n### Additional Features\n\n- ⏱️ **Timer persistence** - Keep elapsed time when switching between tabs\n- 🔄 **Auto-updates** - Server checks for updates automatically\n- 🌙 **Always-on sites** - Configure sites to always show presence even when globally disabled\n- 🖥️ **Cross-platform** - Works on Windows, Mac, and Linux\n- 🛠️ **Customizable** - Use your own Discord application and icons\n\n## 🚀 Quick Install Guide\n\n### Step 1: Install the Server\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"60%\"\u003e\n\n```bash\n# Install with npm (make sure you have Node.js installed)\nnpm install -g webpresence\n\n# Start the server in daemon mode (runs in background)\nwebpresence start -d\n\n# Configure to start automatically on system boot\nwebpresence autostart --enable\n\n# Check if server is running\nwebpresence status\n```\n\n\u003e **Tip:** Using daemon mode (`-d`) lets the server run in the background so you can close your terminal window!\n\n\u003c/td\u003e\n\u003ctd width=\"40%\"\u003e\n\u003cimg src=\"screenshots/installation/server-installation.png\" alt=\"Server Installation\" width=\"100%\"\u003e\n\u003cimg src=\"screenshots/installation/daemon-start.png\" alt=\"Server Start\" width=\"100%\"\u003e\n\u003cimg src=\"screenshots/installation/server-status.png\" alt=\"Server Installation\" width=\"100%\"\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### Step 2: Install the Browser Extension\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"60%\"\u003e\n\n#### Option 1: Download the Source Code\n\nFirst, get the extension files by either:\n\n**Cloning the repository:**\n\n```bash\ngit clone https://github.com/utkarshthedev/webpresence.git\n```\n\n**Or downloading as ZIP:**\n\n1. Go to [GitHub Repository](https://github.com/utkarshthedev/webpresence)\n2. Click the green \"Code\" button\n3. Select \"Download ZIP\"\n4. Extract the ZIP file to a location on your computer\n\n#### For Chrome:\n\n1. Go to `chrome://extensions/`\n2. Turn on \"Developer mode\" (top-right corner)\n3. Click \"Load unpacked\" and select the `client/chrome` folder\n\n#### For Firefox:\n\n1. Go to `about:debugging#/runtime/this-firefox`\n2. Click \"Load Temporary Add-on...\"\n3. Select the `manifest.json` file from the `client/firefox` folder\n\n\u003c/td\u003e\n\u003ctd width=\"40%\"\u003e\n\u003cimg src=\"screenshots/installation/extension_install.png\" alt=\"Extension Installation\" width=\"120%\"\u003e\n\u003cimg src=\"screenshots/installation/install_extension.png\" alt=\"Extension Opening\" width=\"120%\"\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### Step 3: Start Using It!\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"60%\"\u003e\n\n1. Make sure Discord is open on your computer\n2. Click the Web Presence icon in your browser\n3. Toggle the switch to turn it on\n4. Start browsing - your activity will show in Discord!\n\n\u003cp\u003e\u003ca href=\"docs/INSTALLATION.md\"\u003e\u003cstrong\u003e📚 Need more detailed instructions?\u003c/strong\u003e\u003c/a\u003e Check out our comprehensive installation guide!\u003c/p\u003e\n\n\u003c/td\u003e\n\u003ctd width=\"40%\"\u003e\n\u003cimg src=\"screenshots/browser_extension.png\" alt=\"Getting Started\" width=\"100%\"\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n## 🆘 Need Help?\n\n### 📚 Documentation\n\n- [**Installation Guide**](docs/INSTALLATION.md) - Step-by-step setup instructions for beginners\n- [**Autostart Configuration**](docs/AUTOSTART.md) - Make Web Presence start automatically on boot\n- [**Troubleshooting**](docs/TROUBLESHOOTING.md) - Solutions to common problems\n- [**CLI Guide**](docs/CLI.md) - All command-line features explained\n- [**All Documentation**](docs/README.md) - Complete documentation index\n\nOur comprehensive documentation helps you get the most out of Web Presence!\n\n### 🔍 Common Questions\n\n- **How do I start the server?**\n  Run `webpresence start -d` in your terminal\n\n- **How do I check if it's running?**\n  Run `webpresence status` to see server status\n\n- **Can I disable for specific sites?**\n  Yes, click the extension icon and use the site settings\n\n- **Does it work with all websites?**\n  Yes, with custom icons for 100+ popular sites\n\n- **How do I update Web Presence?**\n  Run `npm update -g webpresence` to get the latest version\n\n**Still stuck?** Check the [Troubleshooting Guide](docs/TROUBLESHOOTING.md) for solutions to common issues.\n\n## 👨‍💻 For Developers\n\n### 🛠️ Contribute\n\nWe welcome contributions of all kinds:\n\n- **Add new website icons** - Help expand our collection of custom site icons\n- **Improve documentation** - Make guides clearer and more helpful\n- **Fix bugs and add features** - Enhance functionality and stability\n- **Report issues** - Help identify problems that need fixing\n- **Improve performance** - Optimize code for better efficiency\n\nEvery contribution helps make Web Presence better!\n\n#### Getting Started\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n### 📋 Developer Resources\n\n- [**Developer Guide**](docs/DEVELOPER.md) - Complete development setup and workflow\n- [**API Documentation**](docs/API.md) - REST API and WebSocket reference\n- [**Contributing Guide**](CONTRIBUTING.md) - Detailed instructions for contributors\n- [**Site Icons Guide**](docs/SITE_ICONS.md) - How to add new website icons\n- [**CLI Reference**](docs/CLI.md) - All command-line options\n- [**Server Package**](server/README.md) - WebPresence npm package details\n\n**Want to contribute?** Check out our [open issues](https://github.com/utkarshthedev/webpresence/issues) to find something to work on!\n\n## Using Your Own Discord Application\n\nYou can use your own Discord application instead of the default one:\n\n1. Create a new application at the [Discord Developer Portal](https://discord.com/developers/applications)\n2. Copy your Client ID\n3. Replace the `clientId` in `server/config.ts`\n4. Upload custom icons to your Discord application\n\nThis allows you to customize the appearance of your presence with your own branding and icons.\n\n## Showcase\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch3\u003eWeb Presence in action on popular websites\u003c/h3\u003e\n\n  \u003ctable border=\"0\" cellspacing=\"0\" cellpadding=\"0\" style=\"border: none;\"\u003e\n    \u003ctr style=\"border: none;\"\u003e\n      \u003ctd align=\"center\" width=\"50%\" style=\"border: none; padding: 10px;\"\u003e\n        \u003cdiv style=\"padding: 10px; height: 100%;\"\u003e\n          \u003cimg src=\"screenshots/showcase/youtube.png\" alt=\"YouTube Presence\" width=\"100%\"\u003e\n          \u003cp\u003e\u003cstrong\u003eYouTube\u003c/strong\u003e - Watch videos with style\u003c/p\u003e\n        \u003c/div\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"50%\" style=\"border: none; padding: 10px;\"\u003e\n        \u003cdiv style=\"padding: 10px; height: 100%;\"\u003e\n          \u003cimg src=\"screenshots/showcase/github.png\" alt=\"GitHub Presence\" width=\"100%\"\u003e\n          \u003cp\u003e\u003cstrong\u003eGitHub\u003c/strong\u003e - Show off your coding sessions\u003c/p\u003e\n        \u003c/div\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr style=\"border: none;\"\u003e\n      \u003ctd align=\"center\" width=\"50%\" style=\"border: none; padding: 10px;\"\u003e\n        \u003cdiv style=\"padding: 10px; height: 100%;\"\u003e\n          \u003cimg src=\"screenshots/showcase/twitter.png\" alt=\"Twitter Presence\" width=\"100%\"\u003e\n          \u003cp\u003e\u003cstrong\u003eTwitter/X\u003c/strong\u003e - Share your social media browsing\u003c/p\u003e\n        \u003c/div\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"50%\" style=\"border: none; padding: 10px;\"\u003e\n        \u003cdiv style=\"padding: 10px; height: 100%;\"\u003e\n          \u003cimg src=\"screenshots/showcase/custom.png\" alt=\"Custom Site Presence\" width=\"100%\"\u003e\n          \u003cp\u003e\u003cstrong\u003eAny Website\u003c/strong\u003e - Works with any site you visit\u003c/p\u003e\n        \u003c/div\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n## Project Information\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable border=\"0\" cellspacing=\"0\" cellpadding=\"0\" style=\"border: none; width: 100%;\"\u003e\n    \u003ctr style=\"border: none;\"\u003e\n      \u003ctd align=\"center\" width=\"33%\" style=\"border: none; padding: 10px;\"\u003e\n        \u003ch3\u003e📄 License\u003c/h3\u003e\n        \u003cp\u003eMIT License\u003c/p\u003e\n        \u003cp\u003e\u003ca href=\"LICENSE\"\u003eView License\u003c/a\u003e\u003c/p\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"33%\" style=\"border: none; padding: 10px;\"\u003e\n        \u003ch3\u003e📝 Changelog\u003c/h3\u003e\n        \u003cp\u003eVersion history\u003c/p\u003e\n        \u003cp\u003e\u003ca href=\"server/CHANGELOG.md\"\u003eView Changelog\u003c/a\u003e\u003c/p\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\" width=\"33%\" style=\"border: none; padding: 10px;\"\u003e\n        \u003ch3\u003e👤 Author\u003c/h3\u003e\n        \u003cp\u003eMade with ❤️ by\u003c/p\u003e\n        \u003cp\u003e\u003ca href=\"https://github.com/utkarshthedev\"\u003eUtkarsh Tiwari\u003c/a\u003e\u003c/p\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\n  \u003cp\u003eIf you find this project useful, please consider \u003ca href=\"https://github.com/utkarshthedev/webpresence\"\u003e⭐ starring it on GitHub\u003c/a\u003e!\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Futkarshthedev%2Fwebpresence","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Futkarshthedev%2Fwebpresence","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Futkarshthedev%2Fwebpresence/lists"}