Added docker configuration

This commit is contained in:
Roger Gonzalez 2024-03-09 12:19:03 -03:00
parent 8db41648d4
commit 48c8e08113
Signed by: rogs
GPG Key ID: C7ECE9C6C36EC2E6

View File

@ -14,6 +14,7 @@ Subscleaner is a Python script that removes advertisements from subtitle files.
- Removes a predefined list of advertisement patterns from subtitle files. - Removes a predefined list of advertisement patterns from subtitle files.
- Supports various subtitle formats through the pysrt library. - Supports various subtitle formats through the pysrt library.
- Automatically detects the encoding of subtitle files using chardet. - Automatically detects the encoding of subtitle files using chardet.
- Available as a Docker image for easy deployment and usage.
## Installation ## Installation
@ -47,6 +48,14 @@ cd subscleaner
poetry install poetry install
``` ```
### Docker
Subscleaner is also available as a Docker image. You can pull the image from Docker Hub:
``` sh
docker pull rogsme/subscleaner
```
## Usage ## Usage
If you installed the package automatically, you can pipe a list of subtitle filenames into the script: If you installed the package automatically, you can pipe a list of subtitle filenames into the script:
@ -67,6 +76,36 @@ Alternatively, you can use the script directly if you've installed the dependenc
find /your/media/location -name "*.srt" | python3 subscleaner.py find /your/media/location -name "*.srt" | python3 subscleaner.py
``` ```
### Docker
To use the Docker image, you can run the container with the following command:
``` sh
docker run -e CRON="0 0 * * *" -v /your/media/location:/files rogsme/subscleaner
```
- Replace `0 0 * * *` with your desired cron schedule for running the script.
- Replace `/your/media/location` with the path to your media directory containing the subtitle files.
The Docker container will run the Subscleaner script according to the specified cron schedule and process the subtitle files in the mounted media directory.
#### If you are using YAMS
YAMS is a highly opinionated media server. You can know more about it here: https://yams.media/
Add this container to your `docker-compose.custom.yaml`:
``` sh
subscleaner:
image: rogsme/subscleaner
environment:
- CRON=0 0 * * *
volumes:
- ${MEDIA_DIRECTORY}:/files
```
To get more information on how to add your own containers in YAMS: https://yams.media/advanced/add-your-own-containers/
## Contributing ## Contributing
Contributions are welcome! If you have any suggestions or improvements, feel free to fork the repository and submit a pull request. Contributions are welcome! If you have any suggestions or improvements, feel free to fork the repository and submit a pull request.