README.md

CCTV

Close-Circuit Telegram Vision revolutionizes location tracking with its open-source design and Telegram API integration. Offering precise tracking within 50-100 meters, users can monitor others in real-time for logistics or safety, redefining how we navigate our surroundings

Usage example:

1. Installation

git clone https://github.com/IvanGlinkin/CCTV.git
cd CCTV
pip install -r requirements.txt

2. Registering Telegram creds

visit https://my.telegram.org/auth web-site
input your phone number
input the confirmation/login code
follow "API development tools" link
register the application
get App's api_id, api_hash, title and name

3. Settings
   Upon first launch script will create config.yaml file and request all needed settings.
   This settings can be manually changed later:

api_config:
  api_hash: ***
  api_id: 00000000
  phone: "+123456789000"
location:
  lat: 51.51404
  lon: -0.15063
  meters: 1200
misc:
  speed_kmh: 50
  timesleep: 30

4. Launch

python3 start.py

5. Read the data by opening ./reports-html/_combined_data.html

Help message:

 ██████╗██╗      ██████╗ ███████╗███████╗     ██████╗██╗██████╗  ██████╗██╗   ██╗██╗████████╗                      
██╔════╝██║     ██╔═══██╗██╔════╝██╔════╝    ██╔════╝██║██╔══██╗██╔════╝██║   ██║██║╚══██╔══╝                      
██║     ██║     ██║   ██║███████╗█████╗█████╗██║     ██║██████╔╝██║     ██║   ██║██║   ██║                         
██║     ██║     ██║   ██║╚════██║██╔══╝╚════╝██║     ██║██╔══██╗██║     ██║   ██║██║   ██║                         
╚██████╗███████╗╚██████╔╝███████║███████╗    ╚██████╗██║██║  ██║╚██████╗╚██████╔╝██║   ██║                         
 ╚═════╝╚══════╝ ╚═════╝ ╚══════╝╚══════╝     ╚═════╝╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚═╝   ╚═╝                         
                                                                                                                   
████████╗███████╗██╗     ███████╗ ██████╗ ██████╗  █████╗ ███╗   ███╗    ██╗   ██╗██╗███████╗██╗ ██████╗ ███╗   ██╗
╚══██╔══╝██╔════╝██║     ██╔════╝██╔════╝ ██╔══██╗██╔══██╗████╗ ████║    ██║   ██║██║██╔════╝██║██╔═══██╗████╗  ██║
   ██║   █████╗  ██║     █████╗  ██║  ███╗██████╔╝███████║██╔████╔██║    ██║   ██║██║███████╗██║██║   ██║██╔██╗ ██║
   ██║   ██╔══╝  ██║     ██╔══╝  ██║   ██║██╔══██╗██╔══██║██║╚██╔╝██║    ╚██╗ ██╔╝██║╚════██║██║██║   ██║██║╚██╗██║
   ██║   ███████╗███████╗███████╗╚██████╔╝██║  ██║██║  ██║██║ ╚═╝ ██║     ╚████╔╝ ██║███████║██║╚██████╔╝██║ ╚████║
   ╚═╝   ╚══════╝╚══════╝╚══════╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝      ╚═══╝  ╚═╝╚══════╝╚═╝ ╚═════╝ ╚═╝  ╚═══╝

usage: start.py [-h] [-lat LATITUDE] [-long LONGITUDE] [-m METERS] [-t TIMESLEEP] [-s SPEED_KMH] [-tn TELEGRAM_NAME] [-ti TELEGRAM_API_ID]
                [-th TELEGRAM_API_HASH]

Custom settings for script launch

optional arguments:
  -h, --help            show this help message and exit
  -lat LATITUDE, --latitude LATITUDE
                        Latitude setting
  -long LONGITUDE, --longitude LONGITUDE
                        Longitude setting
  -m METERS, --meters METERS
                        Meters setting
  -t TIMESLEEP, --timesleep TIMESLEEP
                        Timesleep setting
  -s SPEED_KMH, --speed_kmh SPEED_KMH
                        Speed setting
  -tn TELEGRAM_NAME, --telegram_name TELEGRAM_NAME
                        Telegram session name
  -ti TELEGRAM_API_ID, --telegram_api_id TELEGRAM_API_ID
                        Telegram API ID
  -th TELEGRAM_API_HASH, --telegram_api_hash TELEGRAM_API_HASH
                        Telegram API hash

Media mentions:

1. English language:

• https://www.linkedin.com/feed/update/urn:li:activity:7191073927949938688/
• https://www.404media.co/this-tool-shows-some-telegram-users-approximate-physical-location/
• https://www.newsbytesapp.com/news/science/locations-of-telegram-users-are-now-easy-to-find/story
• https://www.transforminggov.ca/taxonomy/1kd79926usd10/
• https://sector035.nl/articles/2024-18
• https://twitter.com/404mediaco/status/1787880234294951949
• https://twitter.com/hack_git/status/1786271191847539117
• https://www.youtube.com/watch?v=AV6E-bUYVSs
• https://knowpy.com/be-careful-if-telegram-has-access-to-your-location-this-portal-reveals-your-position

2. Russian language:

• https://dzen.ru/b/ZjMjQrQIlkH8ypnH
• https://tgstat.ru/channel/@infosec_globe/2642
• https://botiprobiva.org/cctv-api-dlya-otslezhivaniya-mestopolozheniya-v-telegram/
• https://istories.media/news/2024/05/07/vipusknik-universiteta-minoboroni-rf-razrabotal-instrument-kotorii-pozvolyaet-uznat-primernie-adresa-polzovatelei-telegrama/
• https://holod.media/2024/05/08/rossiiskii-khaker-razrabotal/
• https://vk.com/wall-225594201_181?ysclid=lvxhixzl7o951682138
• https://www.securitylab.ru/news/548052.php
• https://meduza.io/news/2024/05/08/vypusknik-universiteta-minoborony-rf-sozdal-instrument-pokazyvayuschiy-primernoe-mestopolozhenie-polzovateley-telegram
• https://t.me/exploitex/14680
• https://t.me/CyberStrikeNews/530
• https://hi-tech.mail.ru/news/109683-srochno-otklyuchite-etu-funkciyu-v-telegram-inache-vas-najdut/
• https://the-geek.ru/news/razrabotan-instrument-dlja-slezhki-za-polzovateljami-telegram?ysclid=lvxwoeu1te198960
• https://skynetzone.org/threads/cctv-novyj-instrument-dlja-slezhki-v-telegram.32700/
• https://www.iguides.ru/main/security/utilita_vychislyayushchaya_tochnoe_mestopolozhenie_polzovateley_telegram/
• https://www.mentoday.ru/life/news/08-05-2024/hakery-vyshli-na-novyi-uroven-oni-mogut-uznat-vashe-tochnoe-mestopolojenie-s-pomoshchyu-telegram/
• https://applespbevent.ru/k-funktsii-liudi-riadom-v-telegram-iest-bolshiie-voprosy-v-planie-konfidientsialnosti-polzovatieliei/

3. Italian language:

• https://www.redhotcyber.com/post/sorveglianza-o-funzionalita-di-telegram-cctv-e-il-nuovo-strumento-che-rintraccia-gli-utenti-in-tempo-reale/

4. Spanish language:

• https://www.adslzone.net/noticias/seguridad/telegram-acceso-ubicacion-posicion/

Video example:

Banned by YouTube

https://github.com/IvanGlinkin/media_support/raw/main/CCTV_Github.mp4

Screenshots: