path: root/README.md

VK scripts
==========

[![Test](https://github.com/egor-tensin/vk-scripts/actions/workflows/test.yml/badge.svg)](https://github.com/egor-tensin/vk-scripts/actions/workflows/test.yml)

A collection of scripts abusing VK.com API.

Installation
------------

    pip install vk-scripts


Python 3.4 or higher is required.
`vk-sessions` uses [matplotlib].

[matplotlib]: http://matplotlib.org/

Usage
-----

* [vk-mutuals] — Learn who your ex and her new boyfriend are both friends
with.
* [vk-status] — Track when people go online/offline.
* [vk-sessions] — View/visualize the amount of time people spend online.

[vk-mutuals]: docs/mutuals.md
[vk-status]: docs/status.md
[vk-sessions]: docs/sessions.md

Development
-----------

### Linting

Requires [Pylint].

    pylint vk

[Pylint]: https://www.pylint.org/

License
-------

Distributed under the MIT License.
See [LICENSE.txt] for details.

[LICENSE.txt]: LICENSE.txt