diff --git a/README.md b/README.md index e37d970..a3691e4 100644 --- a/README.md +++ b/README.md @@ -50,7 +50,8 @@ There are several ways to use it: WinRAR Keygen supports `ASCII`, `ANSI` and `UTF-8` encoding types, the following is a brief description of the three encoding types. > [!WARNING] -> It is recommended that you do not use the ANSI encoding method for the time being, as there are garbled PowerShell console characters for Chinese, Japanese, and Korean on Windows Server 2022 [Microsoft is working on a fix for this issue](https://learn.microsoft.com/en-us/troubleshoot/windows-server/system-management-components/powershell-console-characters-garbled-for-cjk-languages). +> It is recommended that you do not generate licenses with non-ASCII characters in ANSI encoding for the time being, as there is a problem with garbled PowerShell console characters for Chinese, Japanese, and Korean on Windows Server 2022, [which is being fixed by Microsoft](https://learn.microsoft.com/en-us/troubleshoot/windows-server/system-management-components/powershell-console-characters-garbled-for-cjk-languages). +> | Encoding | Instruction | Supported Characters | | -------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | @@ -67,6 +68,14 @@ There are two types of WinRAR licenses, `rarreg.key` and `rarkey.rar`, which dif | | | | Drag to import or place in a location | Double-click to run automatic import | +If you are unable to drag, you can try to put the `rarreg.key` in the following directory. + +```shell +C:\Users\yourname\AppData\Roaming\WinRAR\rarreg.key +``` + +You can also compress `rarreg.key` into `rarkey.rar` and double-click it to run it, and the license import will take place automatically. + ## 6. Use Github Actions
@@ -74,7 +83,7 @@ There are two types of WinRAR licenses, `rarreg.key` and `rarkey.rar`, which dif The new workflow can easily help you generate a license, you just need to follow these steps. -> Your Username and License Name will appear in the Actions log, if you don't want to give out this information, see [7. Using Github Actions with secrets](#7-Use-Github-Actions-with-secrets). +> Your `Username` and `License Name` will appear in the actions log, if you don't want to give out this information, see [7. Using Github Actions with secrets](#7-Use-Github-Actions-with-secrets). ### 6.1 Fork @@ -104,13 +113,13 @@ After allowing the workflow, go to **Actions > WinRAR Keygen > Run workflow** an After running successfully, open the corresponding task and select **rarreg_file** to download. -> Files are retained for 90 days and are automatically destroyed after that time. +> File retention 90 days. ![Download](assets/file-download-light.png#gh-light-mode-only) ![Download](assets/file-download-dark.png#gh-dark-mode-only) -After extract `rarreg_file.zip`, you will get `rarreg.key`, just drag and drop it into WinRAR. You can also compress `rarreg.key` into `rarkey.rar` and double-click it to run it, and the license import will take place automatically. +Extract rarreg_file.zip to get `rarreg.key` and drag to import into WinRAR. You can also compress `rarreg.key` into `rarkey.rar`, then double-click it to run it, and the license import will be done automatically. If you get an invalid key, please check [the specific solution](#9-invalid-key). @@ -121,7 +130,7 @@ If you get an invalid key, please check [the specific solution](#9-invalid-key).
Click to expand -Using [Secrets](https://docs.github.com/en/actions/security-guides/encrypted-secrets) can help you hide license information. +Using [secrets](https://docs.github.com/en/actions/security-guides/encrypted-secrets) can help you hide license information. ### 7.1 Fork @@ -151,11 +160,11 @@ Create three Secrets with the names `TEXT1`, `TEXT2` and `PWD` and fill in the r > The value filled in should be consistent with the type of code you have chosen. -| Secrets Name | Explanation | -| ------------ | ----------------- | -| TEXT1 | Your Name | -| TEXT2 | Your License Name | -| PWD | 7-Zip Password | +| Secrets Name | Explanation | +| ------------------------------- | ------------------------------ | +| TEXT1 | Your Name | +| TEXT2 | Your License Name | +| PWD | 7-Zip Password | ![Add Secrets](assets/secrets-add-light.png#gh-light-mode-only) @@ -169,7 +178,7 @@ Once created, you will see it. ### 7.4 Run workflow -Go to **Actions** and select **WinRAR Keygen Secrets** to run Workflow manually. +Go to **Actions** and select **WinRAR Keygen with secrets** to run workflow manually. For the difference of license encoding, please refer to [4. Encoding](#4-Encoding). @@ -179,13 +188,13 @@ For the difference of license encoding, please refer to [4. Encoding](#4-Encodin After running successfully, open the corresponding task and select **rarreg_file** to download. -> The file will only be available for **1 day**, so please download it in time. +> File retained for **1 day** only. ![Download](assets/file-download-light.png#gh-light-mode-only) ![Download](assets/file-download-dark.png#gh-dark-mode-only) -After extract `rarreg_file.zip`, you will get `rarreg.key`, just drag and drop it into WinRAR. You can also compress `rarreg.key` into `rarkey.rar` and double-click it to run it, and the license import will take place automatically. +Extract rarreg_file.zip to get `rarreg.7z`, unzip it with the password to get `rarreg.key`, then drag and drop to import into WinRAR. You can also compress `rarreg.key` into `rarkey.rar`, then double-click it to run it, and the license import will be done automatically. If you get an invalid key, please check [the specific solution](#9-invalid-key). @@ -295,7 +304,7 @@ winrar-keygen.exe "日本語" "license" | Out-File -Encoding ansi rarreg.key winrar-keygen.exe "한국어" "license" | Out-File -Encoding ansi rarreg.key ``` -When generating utf-8 licenses, you may need to check Use ***Beta:Use Unicode UTF-8 for global language support*** in **Control Panel > Clock and Regions > Regions > Administration > Change System Region Settings** in order to process the data correctly. However, it is not recommended that you do this, which may cause many software to not work properly, and it is recommended to [Use Github Actions](#6-Use-Github-Actions). +When generating utf-8 licenses, you may need to check Use ***[Beta:Use Unicode UTF-8 for global language support](https://stackoverflow.com/a/57134096/10242225)*** in **Control Panel > Clock and Regions > Regions > Administration > Change System Region Settings** in order to process the data correctly. However, it is not recommended that you do this, which may cause many software to not work properly, and it is recommended to [Use Github Actions](#6-Use-Github-Actions). Generate multi-language licenses with UTF-8 encoding. @@ -347,16 +356,6 @@ Please use the following command: winrar-keygen.exe "Github" "Github.com" | Out-File -Encoding ASCII rarreg.key ``` -### 9.3 Location of key - -If you are unable to drag, you can try to put the `rarreg.key` in the following directory. - -```shell -C:\Users\yourname\AppData\Roaming\WinRAR\rarreg.key -``` - -You can also compress `rarreg.key` into `rarkey.rar` and double-click it to run it, and the license import will take place automatically. - ## 10. Contributing ### 10.1 Suggestion diff --git a/README.zh-CN.md b/README.zh-CN.md index 8325903..e6618d6 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -50,13 +50,13 @@ WinRAR 不是免费软件。如果你想使用它，你应当向 [__RARLAB__](ht WinRAR Keygen 支持 `ASCII`、`ANSI` 和 `UTF-8` 三种编码类型，以下是三种编码的简单说明： > [!WARNING] -> 建议暂时先不要使用 ANSI 编码方式，因为在 Windows Server 2022 上中文、日语和韩语的 PowerShell 控制台字符会出现乱码问题，[微软正在修复该问题](https://learn.microsoft.com/en-us/troubleshoot/windows-server/system-management-components/powershell-console-characters-garbled-for-cjk-languages)。 +> 建议暂时不要用 ANSI 编码方式生成非 ASCII 字符的 license，因为在 Windows Server 2022 上中文、日语和韩语的 PowerShell 控制台字符会出现乱码问题，[该问题微软正在修复](https://learn.microsoft.com/en-us/troubleshoot/windows-server/system-management-components/powershell-console-characters-garbled-for-cjk-languages)。 | 编码 | 说明 | 支持的字符 | | -------------------------------------------- | ------------------------------------------------------------ | ----------------------------------------------------- | | [ASCII](https://en.wikipedia.org/wiki/ASCII) | 单字节编码，只使用最下面的 7 位，没有重音符号等 | 仅支持 ASCII 字符 | | ANSI | 没有一种固定的 ANSI 编码。通常说的 ANSI 是指 “系统默认的本地/代码页”，它通过 [Encoding.Default](http://msdn.microsoft.com/en-us/library/system.text.encoding.default.aspx) 获得，通常是 [Windows-1252](http://en.wikipedia.org/wiki/Windows-1252)，但也可以是其他本地 | 仅支持 ASCII 字符和您操作系统所设国家或地区的语言编码 | -| [UTF8](https://en.wikipedia.org/wiki/UTF-8) | 可变长度编码，每个码位 1-4 个字节。ASCII 值用 1 个字节编码为 ASCII | 支持 UTF-8 编码字符 | +| [UTF8](https://en.wikipedia.org/wiki/UTF-8) | 可变长度编码，每个码位 1-4 个字节（ASCII 值用 1 个字节编码为 ASCII） | 支持 UTF-8 编码字符 | ## 5. License 类型 @@ -67,6 +67,14 @@ WinRAR license 有 `rarreg.key` 和 `rarkey.rar` 两种类型，它们仅在导 | | | | 拖动导入或放于指定位置 | 双击运行自动导入 | +如果你无法执行拖动操作，你可以尝试把 `rarreg.key` 放置与以下目录中： + +```shell +C:\Users\yourname\AppData\Roaming\WinRAR\rarreg.key +``` + +你也可以将 `rarreg.key` 压缩成 `rarkey.rar` 然后双击运行，授权导入将会自动进行。 + ## 6. 使用 Github Actions
@@ -74,7 +82,7 @@ WinRAR license 有 `rarreg.key` 和 `rarkey.rar` 两种类型，它们仅在导 新的 workflow 能很方便的帮助你生成 license，你只需跟随以下步骤即可： -> 你的 Username 和 License Name 会出现在 Actions 日志中，如果你不想泄露这些信息，请参考 [7. 使用 Github Actions with secrets](#7-使用-Github-Actions-with-secrets)。 +> 你的 `Username` 和 `License Name` 会出现在 actions 日志中，如果你不想泄露这些信息，请参考 [7. 使用 Github Actions with secrets](#7-使用-Github-Actions-with-secrets)。 ### 6.1 Fork @@ -151,11 +159,11 @@ WinRAR license 有 `rarreg.key` 和 `rarkey.rar` 两种类型，它们仅在导 > 填入的值应与你选择的编码类型保持一致。 -| Secrets Name | Explanation | -| ------------ | ----------- | -| TEXT1 | 用户名 | -| TEXT2 | 许可名 | -| PWD | 压缩包密码 | +| Secrets Name | Explanation | +| ------------------------------- | ------------------------------ | +| TEXT1 | 用户名 | +| TEXT2 | 许可名 | +| PWD | 压缩包密码 | ![Add Secrets](assets/secrets-add-light.png#gh-light-mode-only) @@ -289,7 +297,7 @@ winrar-keygen.exe "日本語" "license" | Out-File -Encoding ansi rarreg.key winrar-keygen.exe "한국어" "license" | Out-File -Encoding ansi rarreg.key ``` -使用 UTF-8 编码生成多语言的 license 时，你可能需要在 “控制面板 > 时钟和区域 > 区域 > 管理 > 更改系统区域设置 ” 中勾选使用 “Beta版:使用Unicode UTF-8提供全球语言支持” 才能正确的处理数据。但是不建议你这么操作，这可能会导致很多软件无法正常运行，建议[使用 Github Actions](#6-使用-Github-Actions)。 +使用 UTF-8 编码生成多语言的 license 时，你可能需要在 “控制面板 > 时钟和区域 > 区域 > 管理 > 更改系统区域设置 ” 中勾选使用 “[Beta版:使用Unicode UTF-8提供全球语言支持](https://stackoverflow.com/a/57134096/10242225)” 才能正确的处理数据。但是不建议你这么操作，这可能会导致很多软件无法正常运行，建议[使用 Github Actions](#6-使用-Github-Actions)。 用 UTF-8 编码生成多语言的 license： @@ -341,17 +349,7 @@ winrar-keygen.exe "Github" "Single PC usage license" > rarreg.key winrar-keygen.exe "Github" "Github.com" | Out-File -Encoding ASCII rarreg.key ``` -### 9.3 Key 的位置 - -如果你无法执行拖动操作，你可以尝试把 `rarreg.key` 放置与以下目录中： - -```shell -C:\Users\yourname\AppData\Roaming\WinRAR\rarreg.key -``` - -你也可以将 `rarreg.key` 压缩成 `rarkey.rar` 然后双击运行，授权导入将会自动进行。 - -### 9.4 关于简体中文版 +### 9.3 关于简体中文版 在 [__RARLAB__](https://www.rarlab.com/) 下载的简体中文版 WinRAR 将会自带广告组件，即使使用了 `rarreg.key` 授权，广告组件依旧会出现。这是由于简体中文代理商的一些意见，RARLAB 已将简体中文安装包的公开链接更换成了带有广告的简体中文安装包。 diff --git a/assets/run-ketgen-dark.png b/assets/run-ketgen-dark.png index 9e2e81e..e083543 100644 Binary files a/assets/run-ketgen-dark.png and b/assets/run-ketgen-dark.png differ diff --git a/assets/run-ketgen-light.png b/assets/run-ketgen-light.png index 6d7bf1e..3926d3e 100644 Binary files a/assets/run-ketgen-light.png and b/assets/run-ketgen-light.png differ diff --git a/assets/run-workflow-dark.png b/assets/run-workflow-dark.png index 04d64cc..ec10515 100644 Binary files a/assets/run-workflow-dark.png and b/assets/run-workflow-dark.png differ diff --git a/assets/run-workflow-light.png b/assets/run-workflow-light.png index 9ce3ae6..bbb9f9f 100644 Binary files a/assets/run-workflow-light.png and b/assets/run-workflow-light.png differ