https://github.com/markusressel/dji-automerge
A small utility to automatically detect and join video segments from DJI drones.
https://github.com/markusressel/dji-automerge
Last synced: 26 days ago
JSON representation
A small utility to automatically detect and join video segments from DJI drones.
- Host: GitHub
- URL: https://github.com/markusressel/dji-automerge
- Owner: markusressel
- License: agpl-3.0
- Created: 2024-04-03T00:56:39.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-07T22:31:08.000Z (about 1 year ago)
- Last Synced: 2024-11-21T01:45:39.703Z (11 months ago)
- Language: Go
- Size: 57.6 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# dji-automerge
A small utility to automatically detect and join video segments from DJI drones.
[](https://asciinema.org/a/650884)
## Why
When you record a video with a DJI drone, the video is split into multiple parts where each of the files is at
most about 4GB in size. This is done to prevent data loss in case of a crash. However, later on this can be annoying
when you want to work with the video files in your editing program of choice.
While there are great tools to join video segments (like f.ex.
gyroflow's [mp4-merge](https://github.com/gyroflow/mp4-merge))
they still require you to manually specify the parts of the video to join.
This tool aims to automate this by automatically detecting and joining video files that belong to the same recording.
## How to use
### Prerequisites
dji-automerge requires `ffmpeg` in your `$PATH` to work. If you don't have it installed yet,
see: https://ffmpeg.org/download.html
### Installation
```shell script
> git clone https://github.com/markusressel/dji-automerge.git
> make build
> ./bin/dji-automerge --input /path/to/videos/ [--filter ".*stabilized.*"] [--output /path/to/videos/]
```
## How it works
dji-automerge works by extracting the first and last frame of each video segment to `/tmp/dji-automerge` and comparing
their similarity. If the last frame of A is similar to the first frame of B, A and B are joined. The similarity of the
frames is determined using [vitali-fedulov/images4](https://github.com/vitali-fedulov/images4).
Video segments are joined using [mp4-merge](https://github.com/gyroflow/mp4-merge). If this is already present in
your `$PATH` it will be used, otherwise it will be downloaded automatically to `/tmp/dji-automerge`.
The resulting joined video files are saved to `/`, the name of the file will be the
name of the first part and a `_joined` suffix, f.ex.: `DJI_0001_joined.MP4`.
After joining the video segments, the original files are moved to `/Sources/`.
# Dependencies
See [go.mod](go.mod)
# License
```
dji-automerge
Copyright (C) 2024 Markus Ressel
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see .
```