omni-tools/README.md

145 lines
3.4 KiB
Markdown
Raw Normal View History

2025-02-26 23:53:30 +00:00
<p align="center">
<img src="src/assets/logo.png" width="300" />
<br /><br />
<a href="https://github.com/iib0011/omni-tools/releases">
<img src="https://img.shields.io/badge/version-0.1.0-blue?style=for-the-badge" />
</a>
<a href="https://hub.docker.com/r/iib0011/omni-tools">
<img src="https://img.shields.io/docker/pulls/iib0011/omni-tools?style=for-the-badge&logo=docker" />
</a>
<a href="https://github.com/iib0011">
<img src="https://img.shields.io/github/stars/iib0011/omni-tools?style=for-the-badge&logo=github" />
</a>
<a href="https://github.com/iib0011/omni-tools/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/iib0011/omni-tools?style=for-the-badge" />
</a>
<!--
<a href="https://discord.gg/SDbbn3hT4b">
<img src="https://img.shields.io/discord/1342971141823664179?label=Discord&style=for-the-badge" />
</a>
-->
<br /><br />
</p>
2024-06-14 00:33:29 +01:00
2025-02-26 23:56:24 +00:00
Welcome to OmniTools, a self-hosted web app offering a variety of online tools to simplify everyday tasks.
Whether you are coding, manipulating images, crunching numbers, or OmniTools has you covered. Please don't forget to
star the repo to support us.
2025-02-23 00:41:04 +01:00
Here is the [demo](https://omnitools.netlify.app/) website.
2024-07-11 03:33:37 +01:00
2025-02-25 17:08:28 +00:00
![img.png](img.png)
2024-06-14 00:33:29 +01:00
## Table of Contents
- [Features](#features)
2025-02-23 02:01:29 +00:00
- [Self-host](#self-hostrun)
2024-06-25 03:38:40 +01:00
- [Contribute](#contribute)
2024-06-14 00:33:29 +01:00
- [License](#license)
- [Contact](#contact)
## Features
2025-02-23 14:11:21 +00:00
We strive to offer a variety of tools, including:
## **Image/Video/Binary Tools**
2024-06-14 00:33:29 +01:00
2025-02-23 14:11:21 +00:00
- Image Resizer
- Image Converter
- Video Trimmer
- Video Reverser
- And more...
2024-06-21 22:44:32 +01:00
2025-02-23 14:11:21 +00:00
## **String/List Tools**
2024-06-21 22:44:32 +01:00
2025-02-23 14:11:21 +00:00
- Case Converters
- List Shuffler
- Text Formatters
- And more...
2024-06-21 22:44:32 +01:00
2025-02-23 14:11:21 +00:00
## **Date and Time Tools**
2024-06-21 22:44:32 +01:00
2025-02-23 14:11:21 +00:00
- Date Calculators
- Time Zone Converters
- And more...
2024-06-21 22:44:32 +01:00
2025-02-23 14:11:21 +00:00
## **Math Tools**
2024-06-21 22:44:32 +01:00
2025-02-23 14:11:21 +00:00
- Generate Prime Numbers
- Generate Perfect Numbers
- And more...
2024-06-21 22:44:32 +01:00
2025-02-23 14:11:21 +00:00
## **Miscellaneous Tools**
2024-06-21 22:44:32 +01:00
2025-02-23 14:11:21 +00:00
- JSON Tools
- XML Tools
- CSV Tools
- And more...
2024-06-21 22:44:32 +01:00
2025-02-23 14:11:21 +00:00
Stay tuned as we continue to expand and improve our collection!
2024-07-11 03:33:37 +01:00
2025-02-23 02:01:29 +00:00
## Self-host/Run
2024-07-11 03:33:37 +01:00
```bash
docker run -d --name omni-tools --restart unless-stopped -p 8080:80 iib0011/omni-tools:latest
```
2024-06-14 00:33:29 +01:00
2024-06-23 18:59:58 +01:00
## Contribute
2024-06-23 18:51:31 +01:00
2025-02-23 14:11:21 +00:00
This is a React Project with Typescript Material UI.
2024-06-23 18:51:31 +01:00
### Project setup
2024-06-14 00:33:29 +01:00
```bash
git clone https://github.com/iib0011/omni-tools.git
2024-06-21 22:44:32 +01:00
cd omni-tools
npm i
npm run dev
2024-06-14 00:33:29 +01:00
```
2024-06-21 22:44:32 +01:00
2024-06-23 19:57:58 +01:00
### Create a new tool
2024-06-23 20:45:03 +01:00
```bash
2025-02-23 14:41:53 +00:00
npm run script:create:tool my-tool-name folder1/folder2 ## examples string/join or image/png/compress
2024-06-23 20:45:03 +01:00
```
2024-06-23 19:57:58 +01:00
2024-06-24 00:59:49 +01:00
Use `folder1\folder2` on Windows
2024-06-28 15:47:54 +01:00
### Run tests
```bash
npm run test
```
- For e2e tests
```bash
2024-06-28 16:44:18 +01:00
npm run test:e2e
2024-06-28 15:47:54 +01:00
```
2025-02-25 07:22:37 +00:00
<img src="https://api.star-history.com/svg?repos=iib0011/omni-tools&type=Date"/>
2024-06-24 00:21:38 +01:00
2025-02-23 00:41:04 +01:00
## 🤝 Looking to contribute?
We welcome contributions! You can help by:
2024-06-21 22:44:32 +01:00
2025-02-23 00:41:04 +01:00
- ✅ Reporting bugs
2025-02-23 02:01:29 +00:00
- ✅ Suggesting new features in Github issues or [here](https://tally.so/r/nrkkx2)
2025-02-23 00:41:04 +01:00
- ✅ Improving documentation
- ✅ Submitting pull requests
2024-06-14 00:33:29 +01:00
2025-02-23 02:01:29 +00:00
You can also join our [Discord server](https://discord.gg/SDbbn3hT4b)
2025-02-23 00:41:04 +01:00
### Contributors
<a href="https://github.com/iib0011/omni-tools/graphs/contributors">
<img src="https://contrib.rocks/image?repo=iib0011/omni-tools" />
</a>
2025-02-23 02:01:29 +00:00
## Contact
For any questions or suggestions, feel free to open an issue or contact me at:
[ibracool99@gmail.com](mailto:ibracool99@gmail.com)
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.