# Remote Detector
A Python CLI tool to detect remote access applications (like AnyDesk, TeamViewer, Getscreen, etc.) running on your system, log ERP login details, and push all logs to MongoDB for centralized monitoring.
---
## Features
- Detects remote access tools running on your system
- Prompts for IIITA ERP login and fetches academic details
- Logs detection events and ERP login info to DB
- Each log includes system username, ERP username, detected app name, and timestamp
- Automatically adds the package to your PATH during installation
---
## Installation
### One-Click Installation (Recommended)
```sh
# Using curl (Mac/Linux)
curl -sSL https://raw.githubusercontent.com/yourusername/remote-detector/main/easy_install.py | python3
# Using wget (Linux)
wget -qO- https://raw.githubusercontent.com/yourusername/remote-detector/main/easy_install.py | python3
# Or download and run the script
python3 easy_install.py
```
The one-click installer will:
- Install the remote-detector package
- Set up PATH automatically
- Configure MongoDB connection URL
- Make the tool immediately usable
### Standard PyPI Installation
```sh
pip3 install remote-detector
```
The installer will automatically try to add the package to your PATH.
### From source
1. **Clone the repository or download the package**
2. **Install the package:**
```sh
pip3 install --upgrade .
```
The installer will attempt to automatically add the package to your PATH.
---
## Environment Setup
**Set your MongoDB connection string as an environment variable:**
```sh
export MONGO_URL=url
```
---
## Usage
Start the CLI tool:
```sh
remote-detector start --duration 0.1
```
- You will be prompted for your ERP username (UID), password, and batch.
- The tool will log ERP details and immediately detect and log any remote access applications running.
- All logs are pushed to your MongoDB collection (`remote_detector.logs`).
---
## Log Structure in MongoDB
Each detection log will look like:
```json
{
"system_username": "<your system username>",
"erp_username": "<ERP UID>",
"app_name": "<name of application detected>",
"timestamp": "<ISO timestamp of detection>"
}
```
---
## Troubleshooting
- If logs do not appear in MongoDB:
- Ensure `pymongo` is installed
- Check your MongoDB URI and network access (IP whitelisting)
- Watch for error messages in your terminal
- If you see logs in `remote_detector.log` file but not in MongoDB, the logger is falling back to file logging due to a connection issue.
- If the `remote-detector` command is not found after installation:
- The installer should automatically add it to your PATH
- You may need to restart your terminal or run `source ~/.bashrc` or `source ~/.zshrc`
- You can manually add the bin directory to your PATH: `export PATH="$HOME/Library/Python/3.x/bin:$PATH"` (replace 3.x with your Python version)
---
## License
MIT
Raw data
{
"_id": null,
"home_page": "https://github.com/yourusername/remote-detector",
"name": "remote-detector",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "remote access, monitoring, security, erp, detection",
"author": "Akshay Waghmare",
"author_email": "your.email@example.com",
"download_url": "https://files.pythonhosted.org/packages/13/cb/0ee38350920d5b86159a1b373285c685ec8d3e40b2edcbd2f87d0734006f/remote_detector-0.1.2.tar.gz",
"platform": null,
"description": "# Remote Detector\n\nA Python CLI tool to detect remote access applications (like AnyDesk, TeamViewer, Getscreen, etc.) running on your system, log ERP login details, and push all logs to MongoDB for centralized monitoring.\n\n---\n\n## Features\n- Detects remote access tools running on your system\n- Prompts for IIITA ERP login and fetches academic details\n- Logs detection events and ERP login info to DB\n- Each log includes system username, ERP username, detected app name, and timestamp\n- Automatically adds the package to your PATH during installation\n\n---\n\n## Installation\n\n### One-Click Installation (Recommended)\n```sh\n# Using curl (Mac/Linux)\ncurl -sSL https://raw.githubusercontent.com/yourusername/remote-detector/main/easy_install.py | python3\n\n# Using wget (Linux)\nwget -qO- https://raw.githubusercontent.com/yourusername/remote-detector/main/easy_install.py | python3\n\n# Or download and run the script\npython3 easy_install.py\n```\nThe one-click installer will:\n- Install the remote-detector package\n- Set up PATH automatically \n- Configure MongoDB connection URL\n- Make the tool immediately usable\n\n### Standard PyPI Installation\n```sh\npip3 install remote-detector\n```\nThe installer will automatically try to add the package to your PATH.\n\n### From source\n1. **Clone the repository or download the package**\n2. **Install the package:**\n ```sh\n pip3 install --upgrade .\n ```\n The installer will attempt to automatically add the package to your PATH.\n\n---\n\n## Environment Setup\n\n**Set your MongoDB connection string as an environment variable:**\n\n```sh\nexport MONGO_URL=url\n```\n\n---\n\n## Usage\n\nStart the CLI tool:\n```sh\nremote-detector start --duration 0.1\n```\n- You will be prompted for your ERP username (UID), password, and batch.\n- The tool will log ERP details and immediately detect and log any remote access applications running.\n- All logs are pushed to your MongoDB collection (`remote_detector.logs`).\n\n---\n\n## Log Structure in MongoDB\nEach detection log will look like:\n```json\n{\n \"system_username\": \"<your system username>\",\n \"erp_username\": \"<ERP UID>\",\n \"app_name\": \"<name of application detected>\",\n \"timestamp\": \"<ISO timestamp of detection>\"\n}\n```\n\n---\n\n## Troubleshooting\n- If logs do not appear in MongoDB:\n - Ensure `pymongo` is installed\n - Check your MongoDB URI and network access (IP whitelisting)\n - Watch for error messages in your terminal\n- If you see logs in `remote_detector.log` file but not in MongoDB, the logger is falling back to file logging due to a connection issue.\n- If the `remote-detector` command is not found after installation:\n - The installer should automatically add it to your PATH\n - You may need to restart your terminal or run `source ~/.bashrc` or `source ~/.zshrc`\n - You can manually add the bin directory to your PATH: `export PATH=\"$HOME/Library/Python/3.x/bin:$PATH\"` (replace 3.x with your Python version)\n\n---\n\n## License\nMIT \n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Detects remote access tools and logs ERP login to MongoDB.",
"version": "0.1.2",
"project_urls": {
"Bug Reports": "https://github.com/yourusername/remote-detector/issues",
"Homepage": "https://github.com/yourusername/remote-detector",
"Source": "https://github.com/yourusername/remote-detector"
},
"split_keywords": [
"remote access",
" monitoring",
" security",
" erp",
" detection"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "947c3fee3a2bf25d2cfb5afbfe0cef48936495946f34a9e6c50cac2404d18bda",
"md5": "ab287ddf1605e0943eb19c0e73d7b8f2",
"sha256": "5675ff28d2e50e6ec940405f45eebf29389a19ecad20e6d3b030f2df4a200261"
},
"downloads": -1,
"filename": "remote_detector-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ab287ddf1605e0943eb19c0e73d7b8f2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 8610,
"upload_time": "2025-07-23T21:23:11",
"upload_time_iso_8601": "2025-07-23T21:23:11.553758Z",
"url": "https://files.pythonhosted.org/packages/94/7c/3fee3a2bf25d2cfb5afbfe0cef48936495946f34a9e6c50cac2404d18bda/remote_detector-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "13cb0ee38350920d5b86159a1b373285c685ec8d3e40b2edcbd2f87d0734006f",
"md5": "7a3f6b6cbd830f1f96aa32a6242045c5",
"sha256": "899f317f446331dfcba3a23eda78de978947c0a7be64a905f4cf3fbc06e0e6bc"
},
"downloads": -1,
"filename": "remote_detector-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "7a3f6b6cbd830f1f96aa32a6242045c5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 11101,
"upload_time": "2025-07-23T21:23:13",
"upload_time_iso_8601": "2025-07-23T21:23:13.004654Z",
"url": "https://files.pythonhosted.org/packages/13/cb/0ee38350920d5b86159a1b373285c685ec8d3e40b2edcbd2f87d0734006f/remote_detector-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-23 21:23:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "remote-detector",
"github_not_found": true,
"lcname": "remote-detector"
}
JSON
