{"id":15134005,"url":"https://github.com/plaxeen/vk-online-checker-python","last_synced_at":"2025-10-23T09:31:21.515Z","repository":{"id":197395456,"uuid":"149563835","full_name":"plaxeen/vk-online-checker-python","owner":"plaxeen","description":"This project offers work with users of the VK. With it, you can track the online status of the user and record his history of visits to the social network.","archived":false,"fork":false,"pushed_at":"2018-10-22T21:50:21.000Z","size":12,"stargazers_count":12,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-30T17:38:24.327Z","etag":null,"topics":["online","python","spy","vk","vk-api","vkontakte"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/plaxeen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-09-20T06:42:44.000Z","updated_at":"2024-10-04T12:46:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"8edad367-125c-46ce-9df0-aa5730e5e05d","html_url":"https://github.com/plaxeen/vk-online-checker-python","commit_stats":null,"previous_names":["plaxeen/vk-online-checker-python"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plaxeen%2Fvk-online-checker-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plaxeen%2Fvk-online-checker-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plaxeen%2Fvk-online-checker-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/plaxeen%2Fvk-online-checker-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/plaxeen","download_url":"https://codeload.github.com/plaxeen/vk-online-checker-python/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237807464,"owners_count":19369596,"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":["online","python","spy","vk","vk-api","vkontakte"],"created_at":"2024-09-26T05:01:55.638Z","updated_at":"2025-10-23T09:31:21.190Z","avatar_url":"https://github.com/plaxeen.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VKOC — VK ONLINE CHECKER\n\nДанный проект предлагает работу с пользователями социальной сети ВКонтакте. С его помощью вы можете отслеживать \nонлайн-статус пользователя и фиксировать его историю посещений социальной сети.\n\n## Описание\nДля работы программы необходим Python не ниже 3 версии. И поставляемый модуль `requests-html`.\n_`pip install requests-html`_\n\n**Программа была придумана и разработана на полном энтузиазме 11 мая 2018 года, автор: \n[Олег Плаксин](https://github.com/plaxin).**\n\n### \u003ca name=\"begin\"\u003e\u003c/a\u003e Начать проверку\nДля того чтобы начать цикл проверок пользователя на нахождение его в сети в социальной сети vk.com — необходимо\nзапустить Python файл `python .\\main.py`. \n\n### \u003ca name=\"params\"\u003e\u003c/a\u003e Передача параметров проверки\n#### \u003ca name=\"params-in\"\u003e\u003c/a\u003e В реальном времени выполнения программы\nСледуйте инструкциям скрипта в командной строке.\n\n#### \u003ca name=\"params-argv\"\u003e\u003c/a\u003e Передача аргументов при запуске\nПрограмма умеет отслеживать передачу аргументов при запуске, а то есть: `python .\\main.py 140830142 0.5`. \nГде:\n* `140830142` — id пользователей в социальной сети, перечисленных через запятую для многопользовательского режима,\n* `0.5` — время ожидания между запросами (задержка программного \nцикла) в минутах. _(0.5 минут = 30 секунд)_.\n\n### \u003ca name=\"data\"\u003e\u003c/a\u003e Работа с данными\nПри правильной работе программы, она логирует всю информацию в командную строку, откуда был произведен запуск и\nодновременно записывает те же данные в файлы, находящиеся по адресу `.\\logs\\%id%\\%yearmonth%\\%date%.log`.\n\nПри условии многопользовательского фиксирования онлайна, директория нахождения логов меняется на: \n`.\\logs\\few users\\%yearmonth%\\%date%.log`.\n\n#### \u003ca name=\"data-init\"\u003e\u003c/a\u003e Первый запуск или инициализация\nПри первом запуске — программа создает `.\\config.ini` файл, или использует существующий, если есть.\n\n##### \u003ca name=\"data-init-config\"\u003e\u003c/a\u003e Содержание config.ini\nФайл `.\\config.ini` должен содержать следующие данные:\n* `[Settings]` — обязательную считываемую программой секцию Settings,\n* Параметр `vkapiuri` должен иметь значение ссылки до API ВКонтакте. По умолчанию, это — `\"https://api.vk.com/method/\"`\n* Параметр `accesstoken` должен содержать сервисный ключ доступа вашего, \n[созданного вами приложения ВКонтакте](https://vk.com/apps?act=manage) или ключ доступа к вашему профилю ВКонтакте,\n* Параметр `vkapiversion` должен содержать последнюю и самую актуальную версию API ВКонтакте на момент последнего \nобновления этой программы.\n\n#### \u003ca name=\"data-view-single\"\u003e\u003c/a\u003e Разбор информации проверки одиночного пользователя\nПрограмма указывает информацию в консоли и в файле в следующем виде:\n```\n01 Sep 2018 00:00:05: main: ### ###\n01 Sep 2018 00:00:05: main: Программный цикл: 273\n\n01 Sep 2018 00:00:05: online: Олег Плаксин был в сети с Android, 31 Aug 2018 23:29:01\n\n01 Sep 2018 00:00:05: user checker: Задержка 97 мс.\n01 Sep 2018 00:00:05: main: Повтор команды через 0.5 минут.\n01 Sep 2018 00:00:05: main: Uptime: 8552525 ms\n```\nГде:\n* `01 Sep 2018 00:00:05` — время фиксации,\n* `main` — название рабочего метода, который выслал информацию в лог,\n* `Программный цикл: 273` — количество фиксаций после запуска программы, \n* `Олег Плаксин был в сети с Android, 31 Aug 2018 23:29:01` — сама информация об активности в социальной сети, с\nуказанием даты последего посещения, передаваемой социальной сетью,\n* `Задержка 97 мс.` — задержка цикла или ping текущего обращения к серверам,\n* `Повтор команды через 0.5 минут.` — уведомление о повторе команды и ее задержки,\n* `Uptime: 8552525 ms` — время безотказной работы после запуска программы.\n\nЗаголовок командной строки, в которой выполняется программа, содержит краткую информацию о последней успешной фиксации:\n`Олег Плаксин был в сети с Android, 23:29:01`. **К сожалению, здесь, пришлось экономить место, и указывать время\nпоследнего посещения без указания даты. Подразумевается, что программа будет использоваться для отслеживания живых \n(активных) пользователей сети.**\n\n#### \u003ca name=\"data-view-multi\"\u003e\u003c/a\u003e Разбор информации многопользовательской проверки\nЛогирование и фиксация пользователей происходит практически также, за исключением выдаваемых строк.\n```\n01 Sep 2018 00:00:05: main: ### ###\n01 Sep 2018 00:00:05: main: Программный цикл: 273\n\n01 Sep 2018 00:00:05: online: Олег Плаксин был в сети с Android, 31 Aug 2018 23:29:01\n01 Sep 2018 00:00:05: online: Соша Греч в сети с iPhone, 31 Aug 2018 23:59:42\n\n01 Sep 2018 00:00:05: user checker: Задержка 97 мс.\n01 Sep 2018 00:00:05: main: Повтор команды через 0.5 минут.\n01 Sep 2018 00:00:05: main: Uptime: 8552525 ms\n```\nИнформацию, о каждом пункте можно узнать из [разбора однопользовательского режима слежения](#data-view-single).\n\nЗаголовок командной строки, в которой выполняется программа, содержит краткую информацию о последней успешной фиксации:\n`2 наблюдаемых / 1 в сети`. **К сожалению, здесь, пришлось экономить место, и указывать только количество пользователей\nв сети из количества пользователей в проверке. Подразумевается, что программа будет использоваться для отслеживания живых \n(активных) пользователей сети.**\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplaxeen%2Fvk-online-checker-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplaxeen%2Fvk-online-checker-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplaxeen%2Fvk-online-checker-python/lists"}