aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
blob: db856b1d9732c37ff708cce948bb3e1c6e81bd46 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
VK scripts
==========

A collection of scripts abusing VK.com API.

Prerequisites
-------------

Requires Python 3.4 or higher.
Additionally, [online_duration.py] requires the excellent [matplotlib] plotting
library to be installed.
The versions I used are listed below.

Software     | Version
------------ | -------
Python       | 3.5.1
[matplotlib] | 1.5.1

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

Usage
-----

The main package is located in the "vk/" directory.

Also, a few scripts are supplied in the "bin/" directory to showcase the
package's capabilities.
Run the scripts from the top-level directory using `python -m`.
Pass the `--help` flag to a script to see its detailed usage information.
The supplied scripts are listed below.

* [mutual_friends.py]: Learn who your ex and her new boyfriend are both friends
with.
* [track_status.py]: Track when people go online/offline.
* [online_duration.py]: View/visualize the amount of time people spend online.

[mutual_friends.py]: docs/mutual_friends.md
[track_status.py]: docs/track_status.md
[online_duration.py]: docs/online_duration.md

License
-------

This project, including all of the files and their contents, is licensed under
the terms of the MIT License.
See [LICENSE.txt] for details.

[LICENSE.txt]: LICENSE.txt