Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/anoduck/vid_sieve
Vid_Sieve helps you remove zero sum and low quality videos from a directory recursively.
https://github.com/anoduck/vid_sieve
clean cleaner cleanup directory filesystem folder media-library movie remover video video-files video-library
Last synced: about 2 months ago
JSON representation
Vid_Sieve helps you remove zero sum and low quality videos from a directory recursively.
- Host: GitHub
- URL: https://github.com/anoduck/vid_sieve
- Owner: anoduck
- License: mit
- Created: 2023-11-16T21:14:23.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2023-11-25T22:22:13.000Z (about 1 year ago)
- Last Synced: 2024-11-18T01:08:37.944Z (about 2 months ago)
- Topics: clean, cleaner, cleanup, directory, filesystem, folder, media-library, movie, remover, video, video-files, video-library
- Language: Python
- Homepage:
- Size: 70.3 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: license.txt
Awesome Lists containing this project
README
```text
;
ED.
E#Wi .
t E###G. ;W t
Ej E#fD#W; f#E Ej
t .DD. E#, E#t t##L .E#f E#, t .DD.
EK: ,WK. E#t E#t .E#K, iWW; E#t EK: ,WK.
E#t i#D E#t E#t j##f L##Lffi E#t E#t i#D
E#t j#f E#t E#t :E#K: tLLG##L E#t E#t j#f
E#tL#i E#t E#t t##L ,W#i E#t E#tL#i
E#WW, E#t E#t .D#W; j#E. E#t E#WW,
E#K: E#t E#tiW#G. .D#j E#t E#K:
ED. E#t E#K##i ,;;;;;;;;;. ,WK, E#t ED.
t E#t E##D. jLLLLLLLLLL, EG. E#t t
,;. E#t , ,;.
L:
```
## Vid Siv
__Hewo!__
Vid_Siv is a video sieve for low quality (>480) videos.
This rather simple script does the following:
- It recursively traverses a directory looking for video files.
- When it finds one, it makes sure it is an actual video file.
- It then checks to see if the file has a size less than configured amount.
- If the file does not meet the minimum required file size it removes it.
- If it does, it then checks to see if the file meets the minimum duration requirement.
- Like before, if the file fails, it is removed. If it succeeds, it moves on to the next filter.
- Lastly, it probes the file for the width. The width is often used to designate quality.
- If the video width does not meet the designated minimum amount, it deletes the file.
- The script is used for removing low quality video files from your system.
__Because, the nineties were not the best time for high def video.__
### Install
Use python poetry to install with `poetry install` or use pipenv to install with `pipenv install`. Which ever
is your choice. Which would look like so:
```commandline
poetry install
```
or
```commandline
pipenv install
```
### Options
I did tried to provide the user with as many options to customize as possible.
_In table form:_
| Option | flag | What it does |
|:-----------|:--------:|:--------------------------------|
| directory | `--dir` | Directory to search in |
| quality | `--qty` | Desired quality (width) |
| duration | `--dur` | Enable and set minimum duration |
| remove | `--rm` | Enable file removal |
| no zero | `--nozo` | Disable zero sum deletion |
| minimum | `--min` | file size for zero sum |
| log level | `--lev` | Set log level to DEBUG or INFO |
| log file | `--log` | Log file path |
| rotate log | `--rot` | Rotate log file when > 512 |
_In raw class form:_
```python
"""Vidsiv helps you remove zero-sum, low quality, and short videos from folders recursively."""
dir: str = os.path.expanduser('~/Videos') # Path of the directory you want sieved.
qty: str = choice("480", "540", "720", "1080", "2k", "4k", default='720') # Choose minimum desired quality in width
dur: int = 60 # Enable and set Minimum allowed duration in secs.
rm: bool = True # Enable/Disable deletion of low quality files.
zo: bool = True # Enable/Disable removal of zero-sum files.
min: int = 512 # Minimum file size in kilobytes, less than is considered zero-sum.
lev: str = choice('info', 'debug', default='info') # Set log level to either INFO or DEBUG
log: str = os.path.abspath('./vidsiv.log') # Full path to log file.
rot: bool = True # Enable/Disable auto rotate log file when > 1MB
```
### Usage
Using Vid_Siv would look something like so:
```commandline
poetry run python vidsiv.py --dir /dir/path --rm
```
* All options possess a default value.
* If no directory is specified on the command line, the script will default to using `/home/$USER/Videos`.
* If the `--rm` flag is not used, the script will do nothing. This is so to prevent accidental deletion of files.
* As a "bonus" feature, you can use the `--dur` flag and remove files based on minimum size as well.
* If you have files less than 512kb that you want to keep, you can either disable zero-sum with `--noz` or change
it with `--min 256`.
#### Caveats
During generation of the file list two approaches were tested, one using normal python file functions, and the
other using trio's asynchronous file functions. For small sets of files, trio's file handling functions outpaced
normal file handling functions by a large margin, but with large sets of files the difference in processing time
became much closer. Still trio's file handling functions was 0.2 secs faster than the standard file handling functions,
averaging about 1.2 secs per file for over 4,000 files. We wish it was faster.
### Thanks
A massively warm thanks goes to the trio gitter channel, who taught me a lot and helped me to troubleshoot this project.
A special thanks goes out to [Arthur Tacca](https://github.com/arthur-tacca) for realizing and providing the
missing feature to the trio asynchronous library, i.e. [aioresult](https://github.com/arthur-tacca/aioresult).
### License
https://anoduck.mit-license.org