diff --git a/README.md b/README.md index e864f49..bec70bb 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # History _py-kms_ is a port of node-kms created by [cyrozap](http://forums.mydigitallife.info/members/183074-markedsword), which is a port of either the C#, C++, or .NET implementations of KMS Emulator. The original version was written by [CODYQX4](http://forums.mydigitallife.info/members/89933-CODYQX4) and is derived from the reverse-engineered code of Microsoft's official KMS. - + # Features - Responds to V4, V5, and V6 KMS requests. - Supports activating: @@ -20,27 +20,30 @@ _py-kms_ is a port of node-kms created by [cyrozap](http://forums.mydigitallife. - Microsoft Office 2016 ( Volume License ) - Microsoft Office 2019 ( Volume License ) - It's written in Python: - - _py2-kms_ tested with Python 2.7.12 - - _py3-kms_ tested with Python 3.5.2 + - tested with Python 2.7.15rc1 + - tested with Python 3.6.7 # Dependencies - Python 3.x or Python 2.7.x or Python 2.6.x with the ```argparse``` module installed. +- Tkinter (optional) if you want to use the GUI. - If the ```tzlocal``` module is installed, the "Request Time" in the verbose output will be converted into local time. Otherwise, it will be in UTC. - It can use the ```sqlite3``` module so you can use the database function, storing activation data so it can be recalled again. -- Installation Example on Ubuntu: - - ```sudo apt-get install python-pip``` - - ```sudo pip install tzlocal``` - - ```sudo apt-get install python-sqlite``` or ```sudo pip install pysqlite``` - +- Installation example on Ubuntu / Mint: + - ```sudo apt-get update``` + - ```sudo apt-get install python3-tk python-tk python-pip``` + - ```sudo pip install tzlocal pysqlite``` + # Usage -- __NOTE__: Pay attention to how invoke scripts, if you want to run _py2-kms_ use ```python...``` while for _py3-kms_ use ```python3...```, also depending on the Python versions that resides in your PC. -- To start the server, execute ```python server.py [IPADDRESS] [PORT]```. +- __NOTE__: Pay attention to how invoke scripts, if you want to run with python2 use ```python...``` while for python3 use ```python3...```, also depending on the Python versions that resides in your PC. +- To start the server, execute ```python pykms_Server.py [IPADDRESS] [PORT]```. The default _IPADDRESS_ is "0.0.0.0" ( all interfaces ) and the default _PORT_ is "1688". -- To run the client (only for testing purposes), use ```python client.py IPADDRESS [PORT]```. -Argument _IPADDRESS_ is always required, while the default _PORT_ is "1688", so a valid command is: ```python client.py 0.0.0.0``` -- To show the help pages type: ```python server.py -h``` and ```python client.py -h``` -- To generate a random HWID use ```-w``` option: ```python server.py -w random``` -- To get the HWID from any server use the client, for example type: ```python client.py 0.0.0.0 1688 -m Windows8.1 -v INFO``` +- To run the client (only for testing purposes), use ```python pykms_Client.py IPADDRESS [PORT]```. +Argument _IPADDRESS_ is always required, while the default _PORT_ is "1688", so a valid command is: ```python pykms_Client.py 0.0.0.0``` +- To show the help pages type: ```python pykms_Server.py -h``` and ```python pykms_Client.py -h``` +- To generate a random HWID use ```-w``` option: ```python pykms_Server.py -w RANDOM``` +- To get the HWID from any server use the client, for example type: ```python pykms_Client.py 0.0.0.0 1688 -m Windows8.1 -V INFO``` +- To view a minimal set of logging informations use ```-V MINI``` option, for example: ```python pykms_Server.py -V MINI``` +- To redirect logging on stdout use ```-F STDOUT``` option, for example: ```python pykms_Server.py -F STDOUT``` # Other Important Stuff Consult the [Wiki](https://github.com/SystemRage/py-kms/wiki) for more informations about activation with _py-kms_ and to get GVLK keys.