https://github.com/aexoden/dashcam
Create timelapse videos from raw dashcam video
https://github.com/aexoden/dashcam
dashcam timelapse
Last synced: 5 months ago
JSON representation
Create timelapse videos from raw dashcam video
- Host: GitHub
- URL: https://github.com/aexoden/dashcam
- Owner: aexoden
- License: mit
- Created: 2022-01-29T04:58:36.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-05-31T14:15:47.000Z (about 1 year ago)
- Last Synced: 2025-06-01T02:33:00.102Z (about 1 year ago)
- Topics: dashcam, timelapse
- Language: Python
- Homepage:
- Size: 123 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# dashcam
## Overview
This project facilitates taking dashcam video from compatible dashcams and
producing timelapse summary videos from the source content, with a GPS map
overlay.
## Requirements
This project leverages [VapourSynth](https://www.vapoursynth.com) for much of
the video processing, and as such, has a somewhat complicated setup process. The
only supported usage method is Docker-based, which ensures that all necessary
dependencies are available.
Please see the `Dockerfile` for a list of current dependencies.
In addition, access to an OpenStreetMap tile server is required to generate the
GPS overlay map. Information about potential providers or instructions to run
your own tile server can be found at .
## Tested Compatible Dashcams
I currently own and test the following two dashcams:
### VanTop H612T
Other cameras from VanTop (or perhaps cameras from other brands that use similar
electronics) may also be compatible, but I am unable to test those. This
particular camera obfuscates its GPS data, so deobfuscation is performed before
generating the final output.
### Mercylion Front 4K (Novatek)
This camera is based on a standard Novatek image processor. Other cameras also
using Novatek processors may be compatible, but again, I am unable to test this.
From my research, some cameras based on Novatek processors obfuscate their GPS
data, but my model does not, so the script currently performs no deobfuscation.
## Usage
First, build the docker image:
`docker build -t dashcam .`
Assuming the image built correctly, use the application as follows:
`docker run -v ":/work" -it dashcam -c `
Replace `` with the path to a directory containing the raw
video files. Replace `` with the URL to an OpenStreetMap tile
server. The default is but this is unlikely to work
unless you happen to already be running a tile server. Replace ``
with either `novatek` or `vantop` as appropriate.
## Contribution
While this software is primarily intended for my own personal use, I am not
opposed to third-party contributions to either fix bugs, add support for
additional camera models, or to add additional features.
I'm particularly unhappy with the way I've currently added support for the
Novatek camera, so the entire GPS module is a strong candidate for refactoring.
As the software works as-is for my use case, I am personally unlikely to do much
development work.
## Author
* Jason Lynch (Aexoden)