godot-docs icon indicating copy to clipboard operation
godot-docs copied to clipboard

Better document the use of HandBrake external tool or directly remove it

Open MarianoGnu opened this issue 8 months ago • 6 comments

Your Godot version: 4.4.1-stable

Issue description: I am dealing with video conversions to be used in an application we are building. This application has some embeded video tutorials. The section Recommended Theora encoding settings recommends to use HandBrake to convert videos, but HandBrake does not seem to export to ogv files, yu can configure mkv with libtheora decode, but that will not work. Maybe ogv was removed and the documentation is outdated

URL to the documentation page: https://docs.godotengine.org/en/stable/tutorials/animation/playing_videos.html#recommended-theora-encoding-settings

MarianoGnu avatar May 12 '25 17:05 MarianoGnu

I wouldn't be surprised if HandBrake removed Theora export, given the format isn't used often anymore.

We can list an alternative open source GUI tool if we find one, but I can't think of any right now.

Calinou avatar May 13 '25 23:05 Calinou

We can list an alternative open source GUI tool if we find one, but I can't think of any right now.

I have used Theora converter .NET on Windows. However, i have had some issues with the video it produced, but i am still not sure of it is the converter's fault or Godot's fault, because video looks okay on Windows media player

MarianoGnu avatar May 14 '25 15:05 MarianoGnu

I wouldn't be surprised if HandBrake removed Theora export, given the format isn't used often anymore.

It looks like it can encode to Theora and Vorbis but only inside the MKV container that isn't supported by Godot.

We can list an alternative open source GUI tool if we find one, but I can't think of any right now.

I have used Theora converter .NET on Windows. However, i have had some issues with the video it produced, but i am still not sure of it is the converter's fault or Godot's fault, because video looks okay on Windows media player

I'd recommend using something newer than that. The best option is a recent FFmpeg nightly build. You can try FFmpegGUI, but if you're not afraid, learning to use the command line for simple conversions is affordable to anyone.

I only use the command line on Linux so if anyone can recommend a GUI we could put it in the documentation.

berarma avatar May 24 '25 16:05 berarma

Shutter Encoder is another GUI that looks very good, cross-platform, opensource and seems to support Theora/ogg.

berarma avatar May 25 '25 08:05 berarma

Another one but only for Windows: Free OGV Video Converter.

berarma avatar May 26 '25 19:05 berarma

#10732 has been tagged to be cherrypicked for the current stable versions. And I'll propose to add Shutter Encoder in another PR.

berarma avatar May 29 '25 07:05 berarma

Closing this as #10732 was merged.

skyace65 avatar Jul 20 '25 13:07 skyace65

For the record, Shutter Encoder hasn't been added to the docs because it uses pretty inefficient encoding parameters. Pushing godotengine/godot#108600 instead.

berarma avatar Jul 20 '25 14:07 berarma