Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add to readme install and arguments #22

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
77 changes: 76 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,45 @@ This will generate a subtilte track (`.srt`) for debugging and the output video
For more info read the help:
`./simple_emh-runnable.py --help`

## Arguments:
```text
filename video file name (or full file path) to classify
--fastcut cut and merge an mp4 video without re-encoding using an edit list.
--window-size-divide divide window size (default: 1s) by this factor
--window-slide-divide divide the window slide by this factor (default: half the window size)
--fps frames per second of the encoded video. Lower FPS mean faster encoding (default: original)
--crf CRF factor for h264 encoding.
--spectrogram print spectrogram of window_size sliding by window_slide during analysis (debubbing only)
--generate-training-data export extracted ehm(s) and silences as well to a separate folder. Useful for training on false positives)
--srt generate subtitle track for easier accuracy evaluation
--keep space separated tags to to be kept in the final video. Eg: ehm silence. Default: speech
--output output video name
--keep-junk keeps tmp files
```

# Install
This script requires `ffmpeg` as dependency.

## Linux
- Install `ffpmeg` with your package manager (Ex: `sudo apt install ffmpeg` for debian-based distros).
- In your installation folder:<br>
```bash
$ git clone https://github.com/morrolinux/simple-ehm
$ cd simple-ehm
$ pip3 install -r requirements.txt
```

## Windows
- Follow the [guide about ffmpeg installation](https://blog.gregzaal.com/how-to-install-ffmpeg-on-windows/)
- In your installation folder:<br>
```bash
$ git clone https://github.com/morrolinux/simple-ehm
$ cd simple-ehm
$ pip3 install -r requirements.txt
```

**NB**: You may need to remove the *MAX_PATH limitation* in order to install dependencies, follow [this official guide](https://docs.python.org/3.7/using/windows.html#removing-the-max-path-limitation).

# Contributing to the model
There are two ways you can contribute to the model:

Expand All @@ -36,6 +75,42 @@ Questo genererò una traccia di sottotitoli (`.srt`) per fini diagnostici e il v
Per maggiori informazioni sui parametri accettati, leggi la guida:
`./simple_emh-runnable.py --help`

## Argomenti:
```text
filename video file name (or full file path) to classify
--fastcut cut and merge an mp4 video without re-encoding using an edit list.
--window-size-divide divide window size (default: 1s) by this factor
--window-slide-divide divide the window slide by this factor (default: half the window size)
--fps frames per second of the encoded video. Lower FPS mean faster encoding (default: original)
--crf CRF factor for h264 encoding.
--spectrogram print spectrogram of window_size sliding by window_slide during analysis (debubbing only)
--generate-training-data export extracted ehm(s) and silences as well to a separate folder. Useful for training on false positives)
--srt generate subtitle track for easier accuracy evaluation
--keep space separated tags to to be kept in the final video. Eg: ehm silence. Default: speech
--output output video name
--keep-junk keeps tmp files
```

# Installazione
Per utilizzare il software è necessario installare `ffmpeg`.

## Linux
- Installare `ffpmeg` mediante il gestore pacchetti della vostra distribuzione (Es: `sudo apt install ffmpeg` per debian derivate).
- Nella cartella in cui si desidera installare:<br>
`git clone https://github.com/morrolinux/simple-ehm` <br>
`cd simple-ehm`<br>
`pip3 install -r requirements.txt`
## Windows
- Seguire la [guida di installazione di ffmpeg](https://blog.gregzaal.com/how-to-install-ffmpeg-on-windows/)
- Nella cartella in cui si desidera installare:<br>
```bash
$ git clone https://github.com/morrolinux/simple-ehm
$ cd simple-ehm
$ pip3 install -r requirements.txt
```

**NB**: Per installare le dipendenze potrebbe essere necessario rimuovere il *MAX_PATH limitation*, seguire [questa guida ufficiale](https://docs.python.org/3.7/using/windows.html#removing-the-max-path-limitation) (aprire l'editor registri e navigare al suo interno per trovare l'etichetta).

# Contribuire al modello
Ci sono due modi in cui puoi contribuire al modello:

Expand All @@ -46,4 +121,4 @@ Inviandomi almeno 30 clip in formato WAV (pcm_s16le) mono con campionamento a 16

## Contribuisci al training
- Implementando la logica di transfer training sul notebook python di questo modello, e
- Eseguendo il retraining della rete esistente con il tuo dataset ed inviandomi il modello aggiornato.
- Eseguendo il retraining della rete esistente con il tuo dataset ed inviandomi il modello aggiornato.