{"id":19462676,"url":"https://github.com/naghim/nicestalker","last_synced_at":"2026-02-26T00:48:47.506Z","repository":{"id":229828979,"uuid":"764343718","full_name":"naghim/NiceStalker","owner":"naghim","description":"Stay connected with your friends! NiceStalker delivers real-time notifications about your friends' Discord online statuses, so you never miss a beat.","archived":false,"fork":false,"pushed_at":"2024-06-29T21:06:05.000Z","size":311,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-29T22:50:27.581Z","etag":null,"topics":["discord","discord-bot","discord-notification","notifier","python","selfbot","toast-notifications","toasted"],"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/naghim.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}},"created_at":"2024-02-27T22:49:42.000Z","updated_at":"2024-10-07T19:23:14.000Z","dependencies_parsed_at":"2024-04-02T19:49:43.713Z","dependency_job_id":"3c63133a-eabc-47eb-9592-e2e5f0e3ce50","html_url":"https://github.com/naghim/NiceStalker","commit_stats":null,"previous_names":["naghim/nicestalker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naghim%2FNiceStalker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naghim%2FNiceStalker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naghim%2FNiceStalker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/naghim%2FNiceStalker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/naghim","download_url":"https://codeload.github.com/naghim/NiceStalker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239742474,"owners_count":19689318,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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-notification","notifier","python","selfbot","toast-notifications","toasted"],"created_at":"2024-11-10T18:04:45.390Z","updated_at":"2026-01-09T22:30:24.140Z","avatar_url":"https://github.com/naghim.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NiceStalker\n\n_\"Day walker, night stalker.\"_\n\nNiceStalker is a simple Discord bot designed to notify users when people become online on Discord. The project name is a playful nod to [Night Stalker](https://www.dota2.com/hero/nightstalker), a character from the popular game Dota 2.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"450\" src=\"images/nicestalker.png\" alt=\"Picture of an example notification\"/\u003e\n\u003c/p\u003e\n\n## Features\n\n:white_check_mark: **Real-time notifications:** NiceStalker keeps track of users' statuses and sends notifications whenever someone comes online on Discord.\n\n:white_check_mark: **Customizable settings:** You can customize your notification preferences, including which users to monitor.\n\n:white_check_mark: **Tray Option**: NiceStalker provides a tray icon functionality allowing you to run the app in the background and access it conveniently from the system tray. NiceStalker can also be stopped through the tray icon menu.\n\n:white_check_mark: **Automatic startup:** If required, NiceStalker can automatically start up on system boot, ensuring that you never miss out on any important alerts.\n\n:white_check_mark: **Easy-to-use interface for configuring the app** NiceStalker offers an intuitive interface to configure the bot's settings. You can easily adjust your notification preferences without the need to use any command-line commands directly.\n\n## Installation\n\n### Windows\n\n1. Download the latest release from the [Releases](https://github.com/naghim/NiceStalker/releases) page.\n\n2. Double-click the downloaded `.exe` file to install the application.\n\n3. Start the application, configure the settings and press \"Start\". To automatically run the application on startup, check the corresponding checkbox.\n\n### Linux and macOS\n\nCurrently, there is no standalone executable for Linux and macOS. You can still run NiceStalker using Python as described below.\n\n### Using Python\n\n#### Pre-requisites\n\nEnsure that you have Python 3.12 installed on your system.\nMake sure `pip` is installed. You can check by running `pip --version` in your terminal.\n\n#### Installation Steps\n\nTo install NiceStalker, follow these steps:\n\n1. Clone the repository to your local machine.\n\n```bash\ngit clone https://github.com/naghim/NiceStalker.git\n```\n\n2. Install the necessary dependencies.\n\n```bash\npython -m pip install -r requirements.txt\n```\n\n3. Ensure that you are logged into the Discord client.\n\n4. _Optional:_ Configure the bot: see steps below.\n\n5. Run the bot.\n\n```bash\npython -m nicestalker\n```\n\nAdding the `--discord` flag at the end will only run the bot without the GUI.\n\n## Configuration\n\nNiceStalker allows you to customize your notification preferences via a `config.json` file. The preferred way of configuration is through the GUI. However, you can also edit the `config.json` file manually.\n\nFor manual configuration, follow the steps below to set up your bot:\n\n1. Create a file named `config.json` in the root directory of the NiceStalker project.\n\n2. Use the following scheme to structure your `config.json` file:\n\n```json\n{\n  \"peopleToStalk\": [\"discord_username\", \"discord_displayname\"],\n  \"peopleToIgnore\": [\"discord_username\", \"discord_displayname\"],\n  \"runOnStartup\": true\n}\n```\n\nReplace `\"discord_username\"` and `\"discord_displayname\"` with the Discord usernames (users' unique identifier) or display names (which is shown to other users) of the individuals you wish to monitor. NiceStalker will notify you whenever these users become online.\n\n**Note:** NiceStalker also supports partial matches for usernames and display names. If you provide a partial username or display name, NiceStalker will match it with any user whose username or display name contains the provided text.\n\nIf the `\"peopleToStalk\"` array is left blank, NiceStalker will notify you whenever **any** user becomes online.\n\nThere is also an option to blacklist users. Create another array in the `config.json` file named `\"peopleToIgnore\"` to add users to the list.\n\nNiceStalker can also be configured to run on startup, to do so, add `\"runOnStartup\": true` to the config file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaghim%2Fnicestalker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnaghim%2Fnicestalker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnaghim%2Fnicestalker/lists"}