marijo/movmaker
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Refine logging and Jamendo docs

Browse source
This commit is contained in:
hbrain 2026-05-25 10:19:45 +00:00
parent 55ee91cae2
commit c42e44231a
3 changed files with 76 additions and 55 deletions
Download patch file Download diff file Expand all files Collapse all files

18
README.md
View file

@ -44,22 +44,22 @@ fc-match 'Bebas Neue'
fc-match 'Noto Sans'
```
## Optional Pixabay music download
## Optional Jamendo music download
If the input folder has no audio file, movmaker can download one random track from Pixabay Music.
If the input folder has no audio file, movmaker can download one random track from Jamendo.
Save your Pixabay API key in either an environment variable:
Save your Jamendo client ID in either an environment variable:
```bash
export PIXABAY_API_KEY='your_key_here'
export JAMENDO_CLIENT_ID='your_client_id_here'
```
or in a local config file:
```bash
mkdir -p ~/.config/movmaker
echo 'PIXABAY_API_KEY=your_key_here' > ~/.config/movmaker/pixabay.env
chmod 600 ~/.config/movmaker/pixabay.env
echo 'JAMENDO_CLIENT_ID=your_client_id_here' > ~/.config/movmaker/jamendo.env
chmod 600 ~/.config/movmaker/jamendo.env
```
The default music search query is:
@ -183,8 +183,8 @@ python3 movmaker.py input --preview
- includes video clips inline
- crossfades between media items over 3 seconds by default
- loops/trims music to match the video
- if no audio file exists in the input folder, searches Pixabay Music using `--music-genre` and downloads one random track; default query is `cinematic punk rock`
- reads the Pixabay API key from `PIXABAY_API_KEY` or `~/.config/movmaker/pixabay.env`
- if no audio file exists in the input folder, searches Jamendo using `--music-genre` and downloads one random track; default query is `cinematic punk rock`
- reads the Jamendo client ID from `JAMENDO_CLIENT_ID` or `~/.config/movmaker/jamendo.env`
- fades music in over 2 seconds and out over 10 seconds by default
- fades video in/out over 1.5 seconds by default
- overlays the opening title for the first 6 seconds: large title, then date/location on one line
@ -195,7 +195,7 @@ python3 movmaker.py input --preview
- embeds MP4 metadata: title, date, location/place, QuickTime location name, artist, comment, and creation_time
- writes an MP4 file named like `YYYYMMDD_title.mp4` in the current directory by default; use `--out-dir DIR` to choose another output directory
- takes `YYYYMMDD` from the first picture/video metadata, falling back to file modification date
- keeps console output minimal during rendering and writes detailed ffmpeg output to `movmaker.log` in the input directory
- keeps console output minimal during rendering and writes detailed ffmpeg output to timestamped logs in `.logs/` inside the input directory
- uses local `ffmpeg/ffmpeg` and `ffmpeg/ffprobe` when present, otherwise system tools
## Notes