{"id":28794244,"url":"https://github.com/yetanothernothacking/oversee","last_synced_at":"2025-07-12T20:12:50.796Z","repository":{"id":292248778,"uuid":"980283797","full_name":"YetAnotherNotHacking/oversee","owner":"YetAnotherNotHacking","description":"View and interact with the world through insecure devices","archived":false,"fork":false,"pushed_at":"2025-07-02T23:46:01.000Z","size":25913,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-03T00:28:29.167Z","etag":null,"topics":["insecure","internet","iot","ipcam","mac","proofofconcept","python","remotecontrol","tkinter","ubuntu","windows"],"latest_commit_sha":null,"homepage":"https://silverflag.net/oversee","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/YetAnotherNotHacking.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}},"created_at":"2025-05-08T21:58:43.000Z","updated_at":"2025-07-02T23:46:04.000Z","dependencies_parsed_at":"2025-05-23T11:59:02.965Z","dependency_job_id":"f4b3d79b-5220-4d6a-a8d1-8ffeb3f5d94c","html_url":"https://github.com/YetAnotherNotHacking/oversee","commit_stats":null,"previous_names":["yetanothernothacking/oversee"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/YetAnotherNotHacking/oversee","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YetAnotherNotHacking%2Foversee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YetAnotherNotHacking%2Foversee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YetAnotherNotHacking%2Foversee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YetAnotherNotHacking%2Foversee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YetAnotherNotHacking","download_url":"https://codeload.github.com/YetAnotherNotHacking/oversee/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YetAnotherNotHacking%2Foversee/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265047848,"owners_count":23703218,"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":["insecure","internet","iot","ipcam","mac","proofofconcept","python","remotecontrol","tkinter","ubuntu","windows"],"created_at":"2025-06-18T02:05:22.391Z","updated_at":"2025-07-12T20:12:50.785Z","avatar_url":"https://github.com/YetAnotherNotHacking.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OVERSEE Worldwide Viewer\n\nA comprehensive GUI application for monitoring and managing IP cameras worldwide. The application provides multiple views including a map view, matrix view, and list view for efficient camera management.\n\n## Features\n- **Map View**: Visualize camera locations on an interactive map\n  - Multiple map styles (OpenStreetMap, Google normal, Google satellite) using tkintermapview\n  - Clickable markers with camera information (in development)\n  - Real-time camera status updates\n  - Automatic geolocation of IP addresses (using ipinfo)\n\n- **Matrix View**: Grid display of multiple camera feeds\n  - Real-time video streams\n  - Customizable grid layout (not much but sure)\n  - Camera status indicators\n\n- **List View**: Detailed camera management\n  - Comprehensive camera information\n  - Camera controls (move, favorite, open in browser)\n  - IP information lookup\n  - Camera status monitoring\n\n## Installation\nBinaries coming soon. They will be located somewhere on silverflag.net. I'll update this with the link when it is ready.\n\n## Function\n1. The application will:\n   - Initialize the IP coordinates database\n   - Load camera information\n   - Start the main GUI\n\n2. Using the interface:\n   - **Map View**: View and interact with camera locations\n   - **Matrix View**: Monitor multiple camera feeds\n   - **List View**: Manage individual cameras\n\n## Configuration\n\n### Settings File\nThe `settings.py` file contains important configuration options:\n- IP list file location\n- Database paths\n- Map tile server settings\n- Camera stream parameters\n\n### IP List Format\nThe IP list file should contain one IP address per line:\nThe list is automatically scraped from Insecam currently.\n```\n192.168.1.1\n10.0.0.1/video\ncamera.example.com:8080\n```\n\n## Project Structure\n\n```\noversee-main/\n├── cam_movement_reversing.md         # Trying to add functionality to the move feature\n├── prepforcommit.sh                  # OLD DO NOT USE IT\n├── .gitignore                        # ... Obv its git ignore?\n├── website/                          # All things that are in the website or the showdan project\n│   ├── gui/                          # All GUI related code\n│   ├── gui/                          # All GUI related code\n│   ├── gui/                          # All GUI related code\n├── src/\n│   │   ├── maingui.py                # Main GUI implementation\n│   ├── gui/                          # All GUI related code\n│   │   ├── maingui.py                # Main GUI implementation\n│   │   ├── aboutgui.py               # Fancy about menu\n│   │   ├── focusedstreamgui.py       # Open stream in new window\n│   │   ├── settingsgui.py            # Settigs window\n│   │   ├── initgui.py                # Loading menu\n│   │   ├── movementgui.py            # Camera movement remote\n│   │   ├── focusedmapgui.py          # Focused map view \"view on map\" in list view\n│   │   └── rendermatrix.py           # Matrix view rendering\n│   ├── backend/                      # Not really backend, just camera management stuff\n│   │   ├── cameradown.py             # All things that are camera \u003e user\n│   │   ├── cameraup.py               # All things that are user \u003e camera\n│   ├── initdata/                     # All of the prelaunch prep ran by initgui\n│   │   ├── getiplistcoordinates.py   # IP coordinate processing\n│   │   ├── formatscrapeddata.py      # Make the scraped ip list compliant with the program\n│   │   ├── getiplist.py              # Threaded insecam scraper\n│   │   ├── headinit.py               # Deprecated and unused function for init (now in initgui)\n│   │   ├── validateiplist.py         # Remove IPs that don't respond (intentionally broken)\n│   │   └── ip2locdownload.py         # Download less precise backup IP2Loc databases\n│   └── utility/                      # Misc escentially.\n│       ├── ip2loc.py                 # IP geolocation utilities\n│       ├── camera_manager.py         # I think unused (maybe) function for managing timed out streams\n│       └── iplist.py                 # IP list handling (e.g. read range)\n├── data/                             # Data that the program gets when it runs\n│   ├── ip_info.db                    # IP coordinate database (stump to grow is at [here](https://silverflag.net/oversee/ip_info.raw))\n│   ├── other                         # General backup ip2loc database files\n│   └── cameras.db                    # Camera status database (Online, Offline, Unkown)\n├── main.py                           # Application entry point (runs init and everything)\n└── requirements.txt                  # Python dependencies\n```\n## Development\n\n### Adding New Features\n1. Fork the repository\n2. Create a feature branch\n3. Implement your changes\n4. Submit a pull request\n\n### Code Style\n- Follow PEP 8 guidelines\n- Use meaningful variable names\n- Add comments for complex logic\n- Update documentation as needed\n\n## Contributing\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\nNone. Steal it and put sprinkles on it.\n\n## Acknowledgments\n- IP geolocation data provided by ipinfo.io\n- Map tiles from OpenStreetMap and Google Maps\n- All contributors and users of the project\n\n## Support\nFor support, please:\n1. Check the documentation (there isn't any yet but there will be)\n2. Search existing issues (In GitHub)\n3. Create a new issue if needed (Also In GitHub)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyetanothernothacking%2Foversee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyetanothernothacking%2Foversee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyetanothernothacking%2Foversee/lists"}