Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kelciour/playphrase
Search and play phrases from movies and audiobooks
https://github.com/kelciour/playphrase
Last synced: about 1 month ago
JSON representation
Search and play phrases from movies and audiobooks
- Host: GitHub
- URL: https://github.com/kelciour/playphrase
- Owner: kelciour
- Created: 2016-12-28T08:32:06.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2021-02-14T14:40:14.000Z (almost 4 years ago)
- Last Synced: 2024-08-05T14:16:13.313Z (3 months ago)
- Language: Python
- Homepage:
- Size: 34.2 KB
- Stars: 166
- Watchers: 8
- Forks: 26
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mpv - playphrase - Search and play phrases from movies and audiobooks. (Subtitle)
README
# PlayPhrase
Search for specific words or phrases in subtitle files and watch video fragments with [mpv](https://mpv.io/).
Inspired by [videogrep](http://lav.io/2014/06/videogrep-automatic-supercuts-with-python/) and [playphrase.me](http://playphrase.me/).
# Video
[](http://youtu.be/ciMEY3moATU)
# Usage
At first, run ```python playphrase.py -i _init_``` to generate txt files from srt files that will be used for searching (only the first time or when you add a new movie in the media folder).
After that, use ```python playphrase.py -i ```
Regular expressions can be used too, for example, \b for word boundary.
### Keyboard Shortcuts
Use ```Enter``` to move to the next clip or ```Shift + <``` and ```Shift + >``` to switch between clips, ```Ctrl + Left``` and ```Ctrl + Right``` to move to the prev/next subtitle, ```q``` to close the video player.
More info: [https://mpv.io/manual/stable/#keyboard-control](https://mpv.io/manual/master/#keyboard-control)
### Batch Scripts
The repository contains ```videogrep.bat``` (Windows) and ```videogrep.sh``` (Linux) files to simplify the user input. Before running it for the first time, edit the file in a text editor and update ```media_dir``` path. Use ```quit```, ```exit``` or ```q```, ```x``` to exit from the batch script.
Here's a quick demo how to set up and run ```videogrep.bat``` on Windows ([YouTube](https://youtu.be/kEkXZY4LFCY)).
### Additional Options:
* ```-p SECONDS, --padding```
padding in seconds to add to the start and the end of each clip (default=0.0 seconds)
* ```-e SECONDS, --ending```
play only matching lines (or phrases)
* ```-r, --randomize```
randomize the clips
* ```-a, --audio```
create audio fragments
* ```-v, --video```
create video fragments
* ```-s, --subtitles```
create subtitles
* ```-vs, --video-sub```
create video fragments with hardcoded subtitles
* ```-o DIRNAME, --output```
the output folder for audio and video fragments (default=.)
* ```-d, --demo```
only show grep results
* ```-g FILENAME, --grep-output```
write the \'grep\' output to the file
* ```-ph GAP_BETWEEN_PHRASES, --phrases```
move the start time of the clip to the beginning of the current phrase (default=1.25 seconds)
* ```-l SECONDS, --limit```
maximum phrase\'s duration (default=60 seconds)
* ```-m OPTIONS, --mpv-options```
mpv player options
### Optional Configuration Changes
For example, you can modify [mpv.conf](https://mpv.io/manual/stable/#configuration-files)
```
autofit=900
geometry=50%:50%
```
and [input.conf](https://mpv.io/manual/stable/#interactive-control)
```
ENTER playlist-next force
```
More info: [https://mpv.io/manual/](https://mpv.io/manual/)
# Download
See [https://github.com/kelciour/playphrase/releases](https://github.com/kelciour/playphrase/releases/latest)
# Usage with AudioBooks
It's possible to use audiobooks as media input. For that purpose there's ```audiogrep.bat``` and ```audiogrep.sh``` files to simplify user input. But you need to generate subtitles for every audio file. It can be done almost automatically using [aeneas](https://github.com/readbeyond/aeneas). Also [csplit](https://en.wikipedia.org/wiki/Csplit) can be used to split text of the book by chapters and [Pragmatic Segmenter](https://github.com/diasks2/pragmatic_segmenter) to split chapter's content by "sentences".
Here's example video how it looks like (YouTube):
[](https://youtu.be/LEyRfy7TsnE)
# Requirements
* python 3
* grep or [ripgrep](https://github.com/BurntSushi/ripgrep) (for non-ASCII languages)
* mpv
* ffmpeg
# Note
* playphrase requires the subtitle track and the video file to have the exact same name, up to the extension.