From 9b00c0df090c5f219785ea4edb7d84050b6790f1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Matteo=20=E2=84=B1an?= Date: Wed, 14 Jun 2017 23:03:14 +0200 Subject: [PATCH] Uploaded readme.md --- README.md | 35 +++++++++++++++++++++++++++++++++-- 1 file changed, 33 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 366a611..b047be0 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,33 @@ -# py-kms -KMS Server Emulator +# History +py-kms is a port of node-kms by [markedsword](http://forums.mydigitallife.info/members/183074-markedsword), which is a port of either the C#, C++, or .NET implementations of KMSEmulator. 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. +PyKMS Author: [cyrozap](http://forums.mydigitallife.info/members/183074-markedsword) +Maintainer: [ColdZero](http://forums.mydigitallife.info/members/108094-ColdZero) + +# Features +- Responds to V4, V5, and V6 KMS requests. +- Supports activating Windows Vista / 7 / 8 / 8.1 / 10 / Server 2008 / Server 2008 R2 / Server 2012 / Server 2012 R2 / Server 2016 / Office 2010 / Office 2013 / Office 2016. +- It's written in Python ( Tested with Python 2.7.8 ). + +# Dependencies +- Python 2.7.x or "Python 2.6.x with the 'argparse' module installed." +- If the "pytz" 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. (it stores activation data so it can be recalled again.) (-s) + - Installation Example on Ubuntu: + - "sudo apt-get install python-pip" + - "sudo pip install pytz" + - "sudo apt-get install python-sqlite" or "sudo pip install pysqlite" + +# Usage +- To start the server, execute "python server.py [listen_IPADDRESS] [PORT]". + The default listen_IPADDRESS is "0.0.0.0" ( all interfaces ) and the default PORT is "1688". +- To run the client, use "python client.py server_IPADDRESS [PORT]". The default PORT is "1688". +- To show the help pages type: "python server.py -h" and "python client.py -h" +- To generate a random HWID type: "python randomHWID.py" or directly in the server ( with -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 Windows81 -v INFO" +- To generate random EPID type: "python randomPID.py" + +# Other Important Stuff +- Read "py-kms_Guide.txt" for more informations about activation with py-kms. +- File "py-kms_ClientKeys.txt" contains GVLK keys. + +