ffmpeg-explorer/README.md

# Interactive FFMPEG Command Generator

A work in progress web tool to explore FFmpeg. Please log [issues/suggestions](https://github.com/antiboredom/ffmpeg-explorer/issues). Made with [svelte](https://svelte.dev/), [xyflow](https://github.com/wbkd/react-flow/tree/xyflow), and [ffmpeg.wasm](https://github.com/ffmpegwasm/ffmpeg.wasm).

Contributions are welcome! Take a look at the todo list below if you'd like to add a new feature, or the issues page if you want to try to fix a bug.

To run in dev mode:

```bash
npm install
npm run dev
```

I'm also looking for good FFmpeg examples. If you make a nice filtergraph in the tool, just hit cmd-s (or ctrl-s on windows/linux), and it will export a json file of your graph. Feel free to post those to the issues page for possible inclusion in the tool.

## Known Issues

- Rendering on chrome doesn't work in multi-threading mode (it seems to fail on mp4s)

## Todo

- [x] Rendering progress bar
- [ ] "Cancel Render" button
- [ ] Disable/enable filters without removing them
- [ ] Deal with duplicate parameters in filters (sometimes filters have a long and short option)
- [ ] Add more help/documentation in the filters (there is more on FFmpeg's site that I could incorporate)
- [ ] Add input options like seek and trim
- [x] Somehow figure out how to deal with complex filtergraphs
- [ ] Add more sample inputs (at least need an image and an audio file)
- [x] Put filter options in a separate panel
- [ ] Add filters that generate content
- [ ] Handle audio and image output.
- [ ] Allow command to be editable
- [x] Use commas to separate filters when possible
- [x] Include some default fonts so text works.
- [x] Allow gif as output
- [ ] Add more tests!
- [x] MAYBE allow users to upload their own videos
- [ ] MAYBE make each part of the output command clickable, to highlight the corresponding nodes
- [ ] MAYBE add previews in the filter list itself

## Inspiration / Alternatives

- [ffmpeg.guide](https://ffmpeg.guide)
- [ffmpeg.app](https://ffmpeg.app)
- [this nice screenshot](https://fosstodon.org/@wader/110855089546846001)
initial 2023-08-18 17:23:56 -04:00			`# Interactive FFMPEG Command Generator`
ok 2023-08-18 18:59:16 -04:00
Update README.md 2023-08-26 17:25:42 -04:00			`A work in progress web tool to explore FFmpeg. Please log [issues/suggestions](https://github.com/antiboredom/ffmpeg-explorer/issues). Made with [svelte](https://svelte.dev/), [xyflow](https://github.com/wbkd/react-flow/tree/xyflow), and [ffmpeg.wasm](https://github.com/ffmpegwasm/ffmpeg.wasm).`
Update readme 2023-08-20 15:57:09 -04:00
Update README.md 2023-08-29 18:40:21 -04:00			`Contributions are welcome! Take a look at the todo list below if you'd like to add a new feature, or the issues page if you want to try to fix a bug.`

Update readme 2023-08-20 15:57:09 -04:00			`To run in dev mode:`

update readme 2023-08-20 15:58:19 -04:00			```bash
Update readme 2023-08-20 15:57:09 -04:00			`npm install`
			`npm run dev`
			```

Update README.md 2023-08-31 12:49:59 -04:00			`I'm also looking for good FFmpeg examples. If you make a nice filtergraph in the tool, just hit cmd-s (or ctrl-s on windows/linux), and it will export a json file of your graph. Feel free to post those to the issues page for possible inclusion in the tool.`

Update readme 2023-08-20 15:57:09 -04:00			`## Known Issues`

			`- Rendering on chrome doesn't work in multi-threading mode (it seems to fail on mp4s)`

			`## Todo`

Update README.md 2023-08-27 17:44:27 -04:00			`- [x] Rendering progress bar`
Update readme 2023-08-20 15:57:09 -04:00			`- [ ] "Cancel Render" button`
			`- [ ] Disable/enable filters without removing them`
			`- [ ] Deal with duplicate parameters in filters (sometimes filters have a long and short option)`
			`- [ ] Add more help/documentation in the filters (there is more on FFmpeg's site that I could incorporate)`
			`- [ ] Add input options like seek and trim`
update readme 2023-08-25 14:43:53 -04:00			`- [x] Somehow figure out how to deal with complex filtergraphs`
Update readme 2023-08-20 15:57:09 -04:00			`- [ ] Add more sample inputs (at least need an image and an audio file)`
update readme 2023-08-25 14:43:53 -04:00			`- [x] Put filter options in a separate panel`
Update readme 2023-08-20 15:57:09 -04:00			`- [ ] Add filters that generate content`
update readme 2023-08-20 16:05:01 -04:00			`- [ ] Handle audio and image output.`
update readme 2023-08-21 12:53:29 -04:00			`- [ ] Allow command to be editable`
Update README.md 2023-08-29 01:15:53 -04:00			`- [x] Use commas to separate filters when possible`
Update README.md 2023-08-29 16:46:59 -04:00			`- [x] Include some default fonts so text works.`
Update README.md 2023-08-29 12:10:30 -04:00			`- [x] Allow gif as output`
Update README.md 2023-08-29 18:42:48 -04:00			`- [ ] Add more tests!`
Update README.md 2023-08-31 12:49:59 -04:00			`- [x] MAYBE allow users to upload their own videos`
update readme 2023-08-25 14:43:53 -04:00			`- [ ] MAYBE make each part of the output command clickable, to highlight the corresponding nodes`
Update readme 2023-08-20 15:57:09 -04:00			`- [ ] MAYBE add previews in the filter list itself`
Update README.md 2023-08-26 17:25:42 -04:00
			`## Inspiration / Alternatives`

			`- [ffmpeg.guide](https://ffmpeg.guide)`
			`- [ffmpeg.app](https://ffmpeg.app)`
			`- [this nice screenshot](https://fosstodon.org/@wader/110855089546846001)`