Welcome to OmniTools, a self-hosted web app offering a variety of online tools to simplify everyday tasks.
Whether you are coding, manipulating images/videos, PDFs or crunching numbers, OmniTools has you covered. Please don't
forget to
star the repo to support us.
Here is the [demo](https://omnitools.app) website.
All files are processed entirely on the client side: nothing ever leaves your device.
Plus, the Docker image is super lightweight at just 28MB, making it fast to deploy and easy to self-host.
## Table of Contents
- [Features](#features)
- [Self-host](#self-hostrun)
- [Contribute](#contribute)
- [License](#license)
- [Contact](#contact)
## Features
We strive to offer a variety of tools, including:
## **Image/Video/Audio Tools**
- Image Resizer
- Image Converter
- Image Editor
- Video Trimmer
- Video Reverser
- And more...
## **PDF Tools**
- PDF Splitter
- PDF Merger
- PDF Editor
- And more...
## **Text/List Tools**
- Case Converters
- List Shuffler
- Text Formatters
- And more...
## **Date and Time Tools**
- Date Calculators
- Time Zone Converters
- And more...
## **Math Tools**
- Generate Prime Numbers
- Calculate voltage, current, or resistance
- And more...
## **Data Tools**
- JSON Tools
- CSV Tools
- XML Tools
- And more...
Stay tuned as we continue to expand and improve our collection!
## Self-host/Run
### Docker
```bash
docker run -d --name omni-tools --restart unless-stopped -p 8080:80 iib0011/omni-tools:latest
```
### Docker Compose
```yaml
services:
omni-tools:
image: iib0011/omni-tools:latest
container_name: omni-tools
restart: unless-stopped
ports:
- "8080:80"
```
## Contribute
This is a React Project with Typescript Material UI. We use icons from [Iconify](https://icon-sets.iconify.design)
### Project setup
```bash
git clone https://github.com/iib0011/omni-tools.git
cd omni-tools
npm i
npm run dev
```
### Create a new tool
```bash
npm run script:create:tool my-tool-name folder1 # npm run script:create:tool split pdf
```
For tools located under multiple nested directories, use:
```bash
npm run script:create:tool my-tool-name folder1/folder2 # npm run script:create:tool compress image/png
```
Use `folder1\folder2` on Windows.
### Run tests
```bash
npm run test
```
- For e2e tests
```bash
npm run test:e2e
```
### 🌐 i18n (Translations)
We use **[Locize](https://locize.com)** for managing translations.
### 🔁 Workflow
1. Join the Locize project** via the [invitation link](https://www.locize.app/register?invitation=Uk9mvOCKkB7sjuUqI5jDBjZROveZIvdBQqzrpmB4oQtT1LNB4BnzzT0S0o1gx79N).
2. Make sure `LOCIZE_API_KEY` is available in your environment (e.g., in `.env`). You can get it from API, CDN, NOTIFICATIONS
3. Pull latest translations** before editing:
```bash
npm run i18n:pull
```
4. **Edit translation files** in `public/locales/{lang}/{namespace}.json`.
5. **Push your changes** after editing:
```bash
npm run i18n:sync
```
## 🤝 Looking to contribute?
We welcome contributions! You can help by:
- Reporting bugs
- Suggesting new features in GitHub issues or [here](https://tally.so/r/nrkkx2)
- Translating in [Locize project](https://www.locize.app/register?invitation=YOIH0Dyz3KHh3uQFCGYe9v1QOUoq8W5ySgmlwjX9cSypeJmt8F40brDtVbXb71fK).
- Improving documentation
- Submitting pull requests
You can also join our [Discord server](https://discord.gg/SDbbn3hT4b)
### Contributors
## 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.
