arti/WindowsXPKg
1
0
Fork 0
mirror of https://github.com/Neo-Desktop/WindowsXPKg synced 2024-11-16 19:00:59 +02:00
Code Issues Packages Projects Releases Wiki Activity
3ae078e3c5
WindowsXPKg/README.md

120 lines
4.2 KiB
Markdown
Raw Normal View History

Add macOS and FreeBSD support and fix DJGPP build (#48)
2023-07-25 09:53:42 +03:00
# Universal MS Key Toolkit (UMSKT)
**Connect with us**
Create README.md
2019-08-21 18:45:36 +03:00
rebrand WindowsXPKg to UMSKT
2023-06-17 00:58:22 +03:00
[![Zulip chat](https://img.shields.io/badge/zulip-join_chat-brightgreen.svg)](https://umskt.zulipchat.com)
use webchat for irc badge
2023-06-06 03:29:39 +03:00
[![libera.chat - #mspid](https://img.shields.io/badge/libera.chat-%23mspid-brightgreen)](https://web.libera.chat/gamja/?nick=Guest?#mspid)
Add macOS and FreeBSD support and fix DJGPP build (#48)
2023-07-25 09:53:42 +03:00
**Build status**
Tidy up Readme - Order Operating Systems - Add separators - Fix build instructions (git clone doesn't just get the code, you need the url)
2023-09-02 00:46:19 +03:00
add actions build badges
2023-06-17 01:07:00 +03:00
[![C/C++ CI (Windows)](https://github.com/UMSKT/UMSKT/actions/workflows/windows.yml/badge.svg)](../../actions/workflows/windows.yml)
Tidy up Readme - Order Operating Systems - Add separators - Fix build instructions (git clone doesn't just get the code, you need the url)
2023-09-02 00:46:19 +03:00
Add macOS and FreeBSD support and fix DJGPP build (#48)
2023-07-25 09:53:42 +03:00
[![C/C++ CI (macOS)](https://github.com/UMSKT/UMSKT/actions/workflows/macos.yml/badge.svg)](../../actions/workflows/macos.yml)
Tidy up Readme - Order Operating Systems - Add separators - Fix build instructions (git clone doesn't just get the code, you need the url)
2023-09-02 00:46:19 +03:00
[![C/C++ CI (Linux)](https://github.com/UMSKT/UMSKT/actions/workflows/linux.yml/badge.svg)](../../actions/workflows/linux.yml)
Update README.md
2023-09-02 18:11:16 +03:00
[![C/C++ CI (FreeBSD)](https://github.com/UMSKT/UMSKT/actions/workflows/freebsd.yml/badge.svg)](../../actions/workflows/freebsd.yml)
add actions build badges
2023-06-17 01:07:00 +03:00
Update README.md
2023-09-02 18:11:16 +03:00
[![C/C++ CI (DOS DJGPP)](https://github.com/UMSKT/UMSKT/actions/workflows/dos-djgpp.yml/badge.svg)](../../actions/workflows/dos-djgpp.yml)
Tidy up Readme - Order Operating Systems - Add separators - Fix build instructions (git clone doesn't just get the code, you need the url)
2023-09-02 00:46:19 +03:00
------
### Plan of Action / ToDo List
update README.md with additional project information
2023-05-30 01:09:20 +03:00
In light of the recent exponential interest in this project I've decided to put updates of this project here:
Tidy up Readme - Order Operating Systems - Add separators - Fix build instructions (git clone doesn't just get the code, you need the url)
2023-09-02 00:46:19 +03:00
[Please see ticket #8 for more information](https://github.com/UMSKT/UMSKT/issues/8)
update README.md with additional project information
2023-05-30 01:09:20 +03:00
------
Update README.md
2023-05-29 21:28:08 +03:00
### **FAQ**
Create README.md
2019-08-21 18:45:36 +03:00
update README.md with additional project information
2023-05-30 01:09:20 +03:00
#### **What does it do?**
Update README.md
2023-07-03 23:40:25 +03:00
* This program is a tool for researching and experimenting with retro Microsoft product licensing, for products released before 2012.
update README.md with additional project information
2023-05-30 01:09:20 +03:00
#### **How does it work?**
* [Enderman's XPKeygen Readme explains everything in detail.](https://github.com/Endermanch/XPKeygen)
#### **How do I use it?**
* It all comes down to four simple steps:
Tidy up Readme - Order Operating Systems - Add separators - Fix build instructions (git clone doesn't just get the code, you need the url)
2023-09-02 00:46:19 +03:00
------
update README.md with additional project information
2023-05-30 01:09:20 +03:00
### **Usage**
Add macOS and FreeBSD support and fix DJGPP build (#48)
2023-07-25 09:53:42 +03:00
#### 1. Download the latest version of UMSKT
update README.md with additional project information
2023-05-30 01:09:20 +03:00
rebrand WindowsXPKg to UMSKT
2023-06-17 00:58:22 +03:00
* *(GitHub account required)*
Only show successful runs on links
2023-08-15 04:35:42 +03:00
* Download the latest experimental version using the Actions tab ([Windows](../../actions/workflows/windows.yml?query=branch%3Amaster+is%3Asuccess), [Linux](../../actions/workflows/linux.yml?query=branch%3Amaster+is%3Asuccess), [macOS](../../actions/workflows/macos.yml?query=branch%3Amaster+is%3Asuccess), [FreeBSD](../../actions/workflows/freebsd.yml?query=branch%3Amaster+is%3Asuccess), [DOS DJGPP](../../actions/workflows/dos-djgpp.yml?query=branch%3Amaster+is%3Asuccess))
update README.md with additional project information
2023-05-30 01:09:20 +03:00
Create README.md
2019-08-21 18:45:36 +03:00
Update README.md
2023-07-29 01:32:15 +03:00
* ~~*(GitHub account \*not\* required)*~~
* ~~Download the latest release for your operating system and architecture from [the releases page](../../releases)~~
* No official releases right now, use the other method to get the latest version.
Add GitHub Actions CI/CD (#23) * Create linux.yml * Create windows.yml * re-enable static builds make a better linux github workflow * better windows action script fix linux output zip * fix path typos * Update readme --------- Co-authored-by: Neo <321592+Neo-Desktop@users.noreply.github.com>
2023-06-16 15:57:56 +03:00
Tidy up Readme - Order Operating Systems - Add separators - Fix build instructions (git clone doesn't just get the code, you need the url)
2023-09-02 00:46:19 +03:00
* **Note:** Before continuing, please ensure you have the `umskt` executable extracted and on UNIX-like systems, have execution permissions (`chmod +x umskt`).
Add GitHub Actions CI/CD (#23) * Create linux.yml * Create windows.yml * re-enable static builds make a better linux github workflow * better windows action script fix linux output zip * fix path typos * Update readme --------- Co-authored-by: Neo <321592+Neo-Desktop@users.noreply.github.com>
2023-06-16 15:57:56 +03:00
Update README.md
2023-09-02 02:54:08 +03:00
#### 2. Install OpenSSL 3.1.2.
For Windows, click [here](https://slproweb.com/products/Win32OpenSSL.html) and choose the right version. For other operating systems, consult your package manager.
*Note: This only applies if the build you download has OpenSSL embedded (static library) or not. You can usually tell if the download size is measured in KB or MB. If it's MB, you don't need this.*
Add GitHub Actions CI/CD (#23) * Create linux.yml * Create windows.yml * re-enable static builds make a better linux github workflow * better windows action script fix linux output zip * fix path typos * Update readme --------- Co-authored-by: Neo <321592+Neo-Desktop@users.noreply.github.com>
2023-06-16 15:57:56 +03:00
Update README.md
2023-09-02 02:54:08 +03:00
#### 3. Run `umskt` to generate a key, or add `--help` or `-h` to see more options.
#### 4. *(Activation step for `Retail` and `OEM` only)*
rebrand WindowsXPKg to UMSKT
2023-06-17 00:58:22 +03:00
* After installation, you will be prompted to activate Windows.
Add GitHub Actions CI/CD (#23) * Create linux.yml * Create windows.yml * re-enable static builds make a better linux github workflow * better windows action script fix linux output zip * fix path typos * Update readme --------- Co-authored-by: Neo <321592+Neo-Desktop@users.noreply.github.com>
2023-06-16 15:57:56 +03:00
Add macOS and FreeBSD support and fix DJGPP build (#48)
2023-07-25 09:53:42 +03:00
* Select the **telephone activation** method, then, run `umskt -i <Installation ID>` using the `Installation ID` the activation Wizard provides for you
Add GitHub Actions CI/CD (#23) * Create linux.yml * Create windows.yml * re-enable static builds make a better linux github workflow * better windows action script fix linux output zip * fix path typos * Update readme --------- Co-authored-by: Neo <321592+Neo-Desktop@users.noreply.github.com>
2023-06-16 15:57:56 +03:00
#### 4. Profit!
Create README.md
2019-08-21 18:45:36 +03:00
update README.md with additional project information
2023-05-30 01:09:20 +03:00
------
Create README.md
2019-08-21 18:45:36 +03:00
Update README.md
2019-08-21 18:52:02 +03:00
Update README.md
2023-05-29 21:28:08 +03:00
### Authors
The list of people who have helped to bring the XP generation to where it is now:
* z22
* MSKey
* diamondggg
* pottzman
* Endermanch
* Neo-Desktop
merge server and confid with xpkey, add LH keys (#18) * merge server and confid with xpkey, add LH keys * improve error handling * update README.md * fix line endings * reorder products section of keys.json * use options as global variable * rename genServer to isBink2002 * small refactor * handle unknown error codepath on confirmation id remove redundant else for BINK1998 generation * finish conversion from std::cout -> fmt::print(); --------- Co-authored-by: Neo <321592+Neo-Desktop@users.noreply.github.com>
2023-06-07 01:04:39 +03:00
* WitherOrNot
Add GitHub Actions CI/CD (#23) * Create linux.yml * Create windows.yml * re-enable static builds make a better linux github workflow * better windows action script fix linux output zip * fix path typos * Update readme --------- Co-authored-by: Neo <321592+Neo-Desktop@users.noreply.github.com>
2023-06-16 15:57:56 +03:00
* TheTank20
Refactor/Overhaul (#40) * major refactor/overhaul move generation implementation to libumskt/* decouple CLI/Options (and JSON) from generation implementation set groundwork for future shared library use standardized PIDGEN2/PIDGEN3 naming convention create a Windows Docker file for quick compilation add Windows resouce file/header so we have an application icon on windows use icon from @Endermanch (used with permission) add support for fully-static linux/muslc-based compilation add support for a dos/windows (i486+) binary using djgpp add Dockerfile to compile gcc/djgpp/watt32/openssl to provide DOS (DPMI) binaries add @Endermanch 's Vista+ documentation update Readme for recent credits * begin work on C linkage and emscripten buildpath * Update CMake to include and build Crypto++ * move dllmain.cpp to the correct directory * add rust port info to README.md * re-add dropped changes from rebase * update build config, specify windows XP version number for crypto++ * update dos-djgpp action to use new cmake builder and options * update dos-djgpp to use UMSKT hosted forks * update other workflows to include standard header * remove crypto++ from build config for now * use the new `shell` parameter in `threeal/cmake-action` TODO: move to a stable version (v1.3.0) when ready * use full commit hash because a shortened hash is unsupported * add the required {0} parameter? * add openssl 3.1.1 to windows github runners * ensure linux matrix build compiles on the correct arch --------- Co-authored-by: Neo <321592+Neo-Desktop@users.noreply.github.com>
2023-07-09 06:08:43 +03:00
* InvoxiPlayGames
* brakmic
Update README.md
2023-09-02 01:19:35 +03:00
* techguy16
Update README.md
2023-05-29 21:28:08 +03:00
(the list will be updated to add more collaborators)
Update README.md
2019-08-21 18:52:02 +03:00
Add GitHub Actions CI/CD (#23) * Create linux.yml * Create windows.yml * re-enable static builds make a better linux github workflow * better windows action script fix linux output zip * fix path typos * Update readme --------- Co-authored-by: Neo <321592+Neo-Desktop@users.noreply.github.com>
2023-06-16 15:57:56 +03:00
------
### **Development Requirements:**
Tidy up Readme - Order Operating Systems - Add separators - Fix build instructions (git clone doesn't just get the code, you need the url)
2023-09-02 00:46:19 +03:00
* `build-essential`
* `cmake`
* `make`
* `gcc`
* `g++`
Add GitHub Actions CI/CD (#23) * Create linux.yml * Create windows.yml * re-enable static builds make a better linux github workflow * better windows action script fix linux output zip * fix path typos * Update readme --------- Co-authored-by: Neo <321592+Neo-Desktop@users.noreply.github.com>
2023-06-16 15:57:56 +03:00
* `git`
#### Build Steps:
Update README.md
2019-08-21 18:52:02 +03:00
Tidy up Readme - Order Operating Systems - Add separators - Fix build instructions (git clone doesn't just get the code, you need the url)
2023-09-02 00:46:19 +03:00
1. `git clone https://github.com/UMSKT/UMSKT`
2. `cd UMSKT/build`
3. `cmake ..`
4. `make`
Refactor/Overhaul (#40) * major refactor/overhaul move generation implementation to libumskt/* decouple CLI/Options (and JSON) from generation implementation set groundwork for future shared library use standardized PIDGEN2/PIDGEN3 naming convention create a Windows Docker file for quick compilation add Windows resouce file/header so we have an application icon on windows use icon from @Endermanch (used with permission) add support for fully-static linux/muslc-based compilation add support for a dos/windows (i486+) binary using djgpp add Dockerfile to compile gcc/djgpp/watt32/openssl to provide DOS (DPMI) binaries add @Endermanch 's Vista+ documentation update Readme for recent credits * begin work on C linkage and emscripten buildpath * Update CMake to include and build Crypto++ * move dllmain.cpp to the correct directory * add rust port info to README.md * re-add dropped changes from rebase * update build config, specify windows XP version number for crypto++ * update dos-djgpp action to use new cmake builder and options * update dos-djgpp to use UMSKT hosted forks * update other workflows to include standard header * remove crypto++ from build config for now * use the new `shell` parameter in `threeal/cmake-action` TODO: move to a stable version (v1.3.0) when ready * use full commit hash because a shortened hash is unsupported * add the required {0} parameter? * add openssl 3.1.1 to windows github runners * ensure linux matrix build compiles on the correct arch --------- Co-authored-by: Neo <321592+Neo-Desktop@users.noreply.github.com>
2023-07-09 06:08:43 +03:00
-----
### **Known Ports**
Tidy up Readme - Order Operating Systems - Add separators - Fix build instructions (git clone doesn't just get the code, you need the url)
2023-09-02 00:46:19 +03:00
| Language | Author | Repo URL |
|----------|-----------|-----------------------------------------------------------|
| Rust | Alex Page | [anpage/umskt-rs](https://github.com/anpage/umskt-rs) |
| Python | techguy16 | [techguy16/umsktpy](https://github.com/techguy16/umsktpy) |
Reference in New Issue Copy Permalink