{"id":51027342,"url":"https://github.com/sea-deep/discord-activity-tracker","last_synced_at":"2026-06-21T20:31:11.119Z","repository":{"id":362925649,"uuid":"1261286191","full_name":"sea-deep/discord-activity-tracker","owner":"sea-deep","description":"A highly detailed, modular Python self-bot script to continuously track and log a specific Discord user's presence, custom statuses, and rich presence activities in real-time.","archived":false,"fork":false,"pushed_at":"2026-06-06T14:34:10.000Z","size":10,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-06T16:13:44.374Z","etag":null,"topics":["discord","discord-bot","discord-py","discord-selfbot","self-bot","selfbot"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sea-deep.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2026-06-06T13:39:11.000Z","updated_at":"2026-06-06T14:34:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sea-deep/discord-activity-tracker","commit_stats":null,"previous_names":["sea-deep/discord-activity-tracker"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/sea-deep/discord-activity-tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sea-deep%2Fdiscord-activity-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sea-deep%2Fdiscord-activity-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sea-deep%2Fdiscord-activity-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sea-deep%2Fdiscord-activity-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sea-deep","download_url":"https://codeload.github.com/sea-deep/discord-activity-tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sea-deep%2Fdiscord-activity-tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34625624,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["discord","discord-bot","discord-py","discord-selfbot","self-bot","selfbot"],"created_at":"2026-06-21T20:31:10.638Z","updated_at":"2026-06-21T20:31:11.114Z","avatar_url":"https://github.com/sea-deep.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Discord Activity Tracker\n\nA Python script designed to track and log a specific Discord user's presence, custom statuses, and rich presence activities using a self-bot approach. \n\nThis project utilizes [discord.py-self](https://github.com/dolfies/discord.py-self) to authenticate as a standard user account. Since traditional Discord bots are restricted from accessing detailed user presence unless they share mutual servers (and require privileged intents), this script operates from your personal account to natively monitor presence data.\n\n## Features\nThe tracker logs the following user activities:\n* **Online Status**: Tracks transitions between Online, Idle, Do Not Disturb, and Offline/Invisible.\n* **Custom Status**: Logs changes to the user's custom status message and associated emojis.\n* **Rich Presence**: Monitors detailed activities such as games played, Spotify listening sessions (including song titles and artists), YouTube watching activity, and streaming status.\n* **Duration Tracking**: Records and calculates the exact duration of each tracked activity or status.\n* **Mutual Server Tracking**: Seamlessly tracks the target user via shared server presence, even if the user is not on your friends list.\n\n---\n\n## Requirements\n\n* **Python 3.8+** installed on your system. \n  * [Windows Installation Guide](https://docs.python.org/3/using/windows.html)\n  * [macOS Installation Guide](https://docs.python.org/3/using/mac.html)\n  * [Linux Installation Guide](https://docs.python.org/3/using/unix.html)\n* A Discord User Token (See the guide below).\n\nIt is highly recommended to run this project inside a Python Virtual Environment (`venv`) to prevent dependency conflicts with other projects.\n\n---\n\n## Getting Your Discord Token\n\nTo use this script, you must obtain your personal Discord user token. **Never share this token with anyone.**\n\n1. Open Discord in your web browser and log in.\n2. Press `Ctrl + Shift + I` (or `Cmd + Option + I` on macOS) to open the browser's Developer Tools.\n3. Navigate to the **Console** tab.\n4. Paste the following script into the console and press Enter:\n\n```javascript\nconst iframe = document.createElement('iframe');\ndocument.body.appendChild(iframe);\nconsole.log('Token:', JSON.parse(iframe.contentWindow.localStorage.token));\niframe.remove();\n```\n\n5. Your token will be printed in the console. Copy the string value without the surrounding quotes.\n\n---\n\n## Quick Start Guide\n\n### 1. Open your Terminal\nBefore running any commands, you need to open your computer's command line interface:\n* **Windows**: Press `Win + R`, type `powershell`, and press Enter.\n* **macOS**: Press `Cmd + Space`, type `terminal`, and press Enter.\n* **Linux**: Press `Ctrl + Alt + T`.\n\n### 2. Clone the Repository\nClone this repository to your local machine and navigate to the project directory:\n```bash\ngit clone https://github.com/sea-deep/discord-activity-tracker.git\ncd discord-activity-tracker\n```\n\n### 3. Set up a Virtual Environment\nCreate and activate a virtual environment:\n```bash\n# On Linux/macOS\npython3 -m venv venv\nsource venv/bin/activate\n\n# On Windows\npython -m venv venv\n.\\venv\\Scripts\\activate\n```\n\n### 4. Install Dependencies\nInstall the required packages using `pip`:\n```bash\npip install -r requirements.txt\n```\n\n### 5. Configure Environment Variables\nRename the included `.env.example` file to `.env` and configure your credentials:\n```env\n# Your personal Discord User Token\nTOKEN=\"your_discord_token_here\"\n\n# The ID of the Discord Server Channel where you want the logs to be sent\nCHANNEL_ID=123456789012345678\n\n# The Discord ID of the user you want to track\nLOGGING_FOR=987654321098765432\n```\n*(To get IDs, go to Discord Settings -\u003e Advanced -\u003e Enable \"Developer Mode\". Right-click a user or channel and click \"Copy ID\")*\n\n### 6. Run the Tracker\nStart the script:\n```bash\npython main.py\n```\nIf configured correctly, the bot will log into your account and begin routing presence updates to your designated channel.\n\n---\n\n## Disclaimer\n**Use this software at your own risk.** Automating user accounts (self-botting) is against Discord's Terms of Service. While `discord.py-self` takes precautions to mimic official clients, there is always a risk of account termination if the API is abused.\n\n## Credits\nThis project relies heavily on the [discord.py-self](https://github.com/dolfies/discord.py-self) wrapper.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsea-deep%2Fdiscord-activity-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsea-deep%2Fdiscord-activity-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsea-deep%2Fdiscord-activity-tracker/lists"}