arti/WindowsXPKg
1
0
Fork 0
mirror of https://github.com/Neo-Desktop/WindowsXPKg synced 2024-11-18 03:41:00 +02:00
Code Issues Packages Projects Releases Wiki Activity
02c85b50b1
WindowsXPKg/README.md

115 lines
3.8 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)
Add macOS and FreeBSD support and fix DJGPP build (#48)
2023-07-25 09:53:42 +03:00
[![C/C++ CI (FreeBSD)](https://github.com/UMSKT/UMSKT/actions/workflows/freebsd.yml/badge.svg)](../../actions/workflows/dos-djgpp.yml)
add actions build badges
2023-06-17 01:07:00 +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
[![C/C++ CI (DOS DJGPP)](https://github.com/UMSKT/UMSKT/actions/workflows/dos-djgpp.yml/badge.svg)](../../actions/workflows/freebsd.yml)
------
### 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
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
#### 2. Run `umskt` to generate a key, or add `--help` or `-h` to see more options.
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
#### 3. *(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-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