From efc47fea0f2dfce5e2bb356717481de460f17110 Mon Sep 17 00:00:00 2001
From: Lyubomir Ternavskiy <127299159+LyubomirT@users.noreply.github.com>
Date: Sun, 22 Sep 2024 17:03:07 +0300
Subject: [PATCH] docs: Revamp README with improved structure and clarity
---
README.md | 100 ++++++++++++++++++++++++++++++++++++++++++++----------
1 file changed, 82 insertions(+), 18 deletions(-)
diff --git a/README.md b/README.md
index 226c63b..39129f8 100644
--- a/README.md
+++ b/README.md
@@ -1,36 +1,100 @@
-# chainsaw-human-typing
+# π― **Chainsaw Human Typing**
-Welcome to the chainsaw-human-typing repository! Chainsaw Human Typing is a tool that allows you to simulate human typing on a keyboard if you can't, or don't want to, paste directly. This is useful for simulating human typing in a video, for example.
+Welcome to the **Chainsaw Human Typing** repository! This tool simulates **human-like typing** on a keyboard when you canβt, or donβt want to, paste directly. It's especially useful for simulating human typing in a video!
-## Getting Started π
+---
-Simply download one a binary from the [releases](https://github.com/LyubomirT/chainsaw-human-typing/releases) page and run it. You can also build it yourself by cloning the repository and running `python main.py`.
+
-## Usage π
+π» **Getting Started** π
-It's οΈquite easy to use, actually! Just type the text you want to simulate typing in the input field and press the "Start Typing" button. The text will be typed out in the input field below. You can see the progress in the progress bar.
+
-## Run from Source π
+Download one of the binaries from the [releases page](https://github.com/LyubomirT/chainsaw-human-typing/releases) or build it yourself by cloning the repository and running:
-To run the project from source, you need to have Python 3.6 or higher installed. You also must install the dependencies by running `pip install -r requirements.txt`. After that, move to the `src` directory and run `python main.py` to run the project.
+```bash
+python main.py
+```
-To build the project, you can use PyInstaller. `build.ps1` is a PowerShell script that builds the project using PyInstaller. You can run it by running `.\build.ps1`. The output will be in the `dist` folder, note that the script is configured to build a Windows executable and that you need to have PyInstaller installed.
+---
-## Contributing π€
+
-If you want to contribute to this project, feel free to fork it and submit a pull request. I'll be happy to review it! If you have any questions, feel free to open an issue. Please check the [CONTRIBUTING](CONTRIBUTING.md) file for more information.
+βοΈ **Usage** π
-## License π
+
-This project is licensed under the GPL-3.0 License - see the [LICENSE](LICENSE) file for details.
+Itβs very **simple** to use! Input the text you want to simulate, then hit **"Start Typing"**. Your text will appear in the lower input field as it's typed out, with a **progress bar** to monitor the process.
-## Translations π
+---
-- δΈζ/Chinese README [README-ZHCN](https://github.com/LyubomirT/chainsaw-human-typing/readmes/README-Chinese.md)
-- Norwegian README [README-NO]([https://](https://github.com/LyubomirT/chainsaw-human-typing/readmes/README-Norwegian.md))
+
-## Acknowledgements π
+π **Run from Source**
+
+
+
+Ensure you have **Python 3.6+** installed. Install the dependencies:
+
+```bash
+pip install -r requirements.txt
+```
+
+Navigate to the `src` folder and run:
+
+```bash
+python main.py
+```
+
+To **build** the project, use **PyInstaller**. The `build.ps1` script automates this for **Windows**:
+
+```bash
+.\build.ps1
+```
+
+The output will be in the `dist` folder.
+
+---
+
+
+
+π€ **Contributing**
+
+
+
+Feel free to fork this project and submit a **pull request**. Iβd be more than happy to review your contributions. If you have any questions, open an **issue**!
+
+See the [CONTRIBUTING](CONTRIBUTING.md) file for more details.
+
+---
+
+
+
+π **License**
+
+
+
+This project is licensed under **GPL-3.0**. See the [LICENSE](LICENSE) file for more information.
+
+---
+
+
+
+π **Translations Available**
+
+
+
+- δΈζ/Chinese README: [README-ZHCN](https://github.com/LyubomirT/chainsaw-human-typing/readmes/README-Chinese.md)
+- Norwegian README: [README-NO](https://github.com/LyubomirT/chainsaw-human-typing/readmes/README-Norwegian.md)
+
+---
+
+
+
+π **Acknowledgements**
+
+
- [PyQt5](https://pypi.org/project/PyQt5/)
- [PyInstaller](https://pypi.org/project/pyinstaller/)
-- [PyNput](https://pypi.org/project/pynput/)
+- [PyNput](https://pypi.org/project/pynput/)
\ No newline at end of file