7x31
/
py-kms
mirror of https://github.com/SystemRage/py-kms.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
py-kms/docs
History
Simon Beginn 702c905185 Added table support 2020-08-01 14:36:34 +02:00
..
img Switched to local copies of images 2020-08-01 12:52:13 +02:00
Documentation.md Added tables? 2020-08-01 14:24:58 +02:00
Getting Started.md Merged manual execution information 2020-08-01 13:51:06 +02:00
Keys.md Key table reformat 2020-08-01 13:02:58 +02:00
Makefile Modified rtd template 2020-07-31 16:25:20 +02:00
TODO Added table support 2020-08-01 14:36:34 +02:00
Usage.md Switched to local copies of images 2020-08-01 12:52:13 +02:00
changelog.md Added changelog to docs 2020-08-01 14:19:17 +02:00
conf.py Added table support 2020-08-01 14:36:34 +02:00
index.rst Removed empty lines 2020-07-31 19:17:02 +02:00
make.bat Modified rtd template 2020-07-31 16:25:20 +02:00
readme.md Moved readme file 2020-08-01 13:38:41 +02:00
requirements.txt Added table support 2020-08-01 14:36:34 +02:00

readme.md

Readme

repo-size open-issues last-commit docker-status docker-pulls

History

py-kms is a port of node-kms created by cyrozap, which is a port of either the C#, C++, or .NET implementations of KMS Emulator. The original version was written by 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:
    • Windows Vista
    • Windows 7
    • Windows 8
    • Windows 8.1
    • Windows 10 ( 1511 / 1607 / 1703 / 1709 / 1803 / 1809 )
    • Windows 10 ( 1903 / 1909 / 20H1 )
    • Windows Server 2008
    • Windows Server 2008 R2
    • Windows Server 2012
    • Windows Server 2012 R2
    • Windows Server 2016
    • Windows Server 2019
    • Microsoft Office 2010 ( Volume License )
    • Microsoft Office 2013 ( Volume License )
    • Microsoft Office 2016 ( Volume License )
    • Microsoft Office 2019 ( Volume License )
  • It's written in Python (tested with Python 3.6.7)
  • Supports execution by Docker, systemd, Upstart and many more...
  • Includes a GUI for simlpe managing
  • Uses sqlite for persistent data storage

Documentation

Read the Docs

The documentation has been completly reworked and is now available on readthedocs.com. It should you provide all necessary information how to get py-kms up and running using your favourite tools - all without clumping this readme up. The documentation also houses more information about activation with py-kms and to how get GVLK keys.

Get it running (fast)...

  • To start the server manually, execute python3 pykms_Server.py [IPADDRESS] [PORT], the default IPADDRESS is :: ( all ipv6-interfaces ) and the default PORT is 1688. Note that both the address and port are optional. Also note that it is recommended to use an IPv6 address - even if you are just plan to use IPv4 (the kernel maps the incoming IPv4 requests automatically to IPv6)!
  • To start the server automatically using Docker, execute docker run -d --name py-kms --restart always -p 1688:1688 pykmsorg/py-kms.
  • To run the client (only for testing purposes), use python3 pykms_Client.py [IPADDRESS] [PORT], with the same defaults of pykms_Server.py.
  • To show the help pages type: python3 pykms_Server.py -h and python3 pykms_Client.py -h.
  • For launching py-kms GUI make the file pykms_Server.py executable with chmod +x /path/to/folder/py-kms/pykms_Server.py, then simply run pykms_Server.py by double-clicking.

If you wish to learn more about using py-kms, please refer to the documentation [here](Getting Started.md)!

License

  • py-kms is Unlicense
  • py-kms GUI is MIT © Matteo ℱan