dashcam-transporter - GitLite

KO | EN

gitlite — search

#javascript #typescript #go #golang #android #machine-learning #deep-learning #macos #nodejs #windows #awesome #mcp #ios #open-source

dashcam-transporter

(★ 115)

Application running on a raspberry pi, to transfer your dashcam video files to your preferred storage

파일 탐색기

최종 버전 다운로드 (.zip)

- - ci.yml
  - release.yml
- - app.ts
  - DashcamDownloader.ts
  - GlobalState.ts
  - HomeTransfer.ts
  - Logger.ts
  - RaspiLed.ts
  - Settings.ts
  - utils.ts
  - WIFI.ts
- - run.js
- .eslintrc.yml
- .gitignore
- package-lock.json
- package.json
- settings.template.ini
- tsconfig.json
- - transfer_illustration.svg
- .package-lock.json
- - conffiles
  - control
  - dashcam-transporter
  - dashcam-transporter-leds.rules
  - dashcam-transporter.logrotate
  - dashcam-transporter.rules
  - dashcam-transporter.service
  - postinst
  - postrm
  - prerm
- build-deb.sh
install.sh
LICENSE
package-lock.json
README.md
release.config.cjs
renovate.json

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/steve192/dashcam-transporter

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd dashcam-transporter

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

cd backend

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# dashcam-transporter
Application running on a raspberry pi (or other debian based platforms), to transfer and archive your dashcam video files to your preferred storage

![Transfer illustration](https://raw.githubusercontent.com/steve192/dashcam-transporter/main/docs/img/transfer_illustration.svg "Transfer illustration")

# How it works
- The application is searching for the WIfi of your dashcam
- If found it connects to it in searches for locked videos (those where something happened), downloads them and deletes them from the dashcam
- The application then searches for your home network, connects and uploads the videos and deletes them from the pi

# Currently supported dashcams
- ✅ Viofo Dashcams 
  - ✅ Viofo A119 Mini
  - ✅ Viofo A229 Pro
  - Other Viofo Dashcams (untested)

# Currently supported target storages
- ✅ Samba (SMB) Windows Share
- ✅ Nextcloud WebDAV

# Installation
The supported installation method is the `.deb` package (install script or manual download). Source installs are for development only.

## Automated script
- Setup raspbian lite (or other debian based os, this is not tested though) and execute

`curl -o- https://raw.githubusercontent.com/steve192/dashcam-transporter/main/install.sh | bash`

This installs the latest `.deb` release, sets up a systemd service, and keeps configuration in `/etc/dashcam-transporter/settings.ini`.

## Update
- Update to the latest release with

`sudo dashcam-transporter update`

## Logs
- Logs are written to `/var/log/dashcam-transporter/app.log`
- View logs with `sudo dashcam-transporter logs`
- Configure log level in `/etc/dashcam-transporter/settings.ini` under `[logging]` (debug/info/warn/error)

## Uninstall
- Remove the package (keep config): `sudo apt remove dashcam-transporter`
- Remove everything including config: `sudo apt purge dashcam-transporter`

## Manual
- Download the `.deb` release for your architecture (armhf/arm64/amd64/i386)
- Install it: `sudo apt install ./dashcam-transporter_<version>_<arch>.deb`
- Edit the configuration: `sudo nano /etc/dashcam-transporter/settings.ini`
- Check service status: `sudo dashcam-transporter status`

## Network manager
- The installer enables NetworkManager and disables `dhcpcd` (required for nmcli-based WiFi control).
- To skip this step, create `/etc/dashcam-transporter/skip-networkmanager-setup` before installation.

# Test a branch on Raspberry Pi 
This runs the app from source on the Pi for development.
- If you installed the stable version: SSH into the Pi and stop the service so only one instance runs: `sudo systemctl stop dashcam-transporter`
- Clone the repo: `git clone https://github.com/steve192/dashcam-transporter.git`
- Fetch and checkout the branch: `git fetch origin && git checkout <branch>`
- Enter the directory: `cd dashcam-transporter`
- Install dependencies and build: `cd backend && npm ci && npm run build`
- Run the branch build: `node dist/app.js`
- When done, stop the process and restart the service: `sudo systemctl start dashcam-transporter`

Tip: Use a separate settings file by exporting `DASHCAM_TRANSPORTER_SETTINGS=/etc/dashcam-transporter/settings.test.ini` before running `node dist/app.js`.

# Meaning of leds
The script controls the raspberrys leds
- Fast blinking LEDs - Transferring from dashcam to the Pi
- Slow blinking LEDs - Transferring from the Pi to the target storage
- Double blink then pause - Idle (waiting for next transfer)