https://github.com/pupil-labs/pl-recover-recording
https://github.com/pupil-labs/pl-recover-recording
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/pupil-labs/pl-recover-recording
- Owner: pupil-labs
- License: mit
- Created: 2024-02-12T16:36:44.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-10T13:40:27.000Z (about 1 year ago)
- Last Synced: 2024-04-13T23:07:38.118Z (about 1 year ago)
- Language: Python
- Size: 52.7 MB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.rst
- License: LICENSE
Awesome Lists containing this project
README
# Pupil Labs Recording Fixer
This is a utility script to fix recordings with corrupted video due to app crash
manifesting in unplayable videos due to missing moov atom or muxing issue resulting in
header error.
## Install
1. Install Python 3.10 or higher
2. ```bash
$ pip install -e git+https://github.com/pupil-labs/pl-recover-recording.git#egg=pl-recover-recording
```
## Usage
```bash
$ pl-recover-recording --help
Usage: pl-recover-recording [OPTIONS] REC_PATH
Recover a recording
╭─ Arguments ──────────────────────────────────────────────────────────────────────────╮
│ * rec_path PATH [default: None] [required] │
╰──────────────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────────────╮
│ --cleanup-temp-files --no-cleanup-temp-files [default: cleanup-temp-files] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────╯
```
### Development
### Building Untrunc
It is important to use the 3.3.9 version of ffmpeg when building untrunc since the newer
versions 4+ do not work.
```bash
sudo apt install build-essentials yasm wget git
git clone https://github.com/anthwlock/untrunc
cd untrunc
make FF_VER=3.3.9
sudo cp untrunc /usr/local/bin
```
### Reference Video Creation
To recover video requires a known good reference video that is used to untruncate the
broken video. Reference videos have already been created for Neon recordings.
#### Neon Reference Video
##### Scene
- Scene reference video is created by muxing a pi recording audio track (41,000hz)
with a neon video track
##### Sensor
- Sensor reference video is created by taking a regular Neon Sensor Module video