Selfhosted

I agree that the comment was rude. Specifically with the "barely tested" asumption/accusation.

No one is being a jerk here

Really? Literally the only thing they said was

Missing the ”made using AI, barely tested” disclaimer I see…

They didn't ask a question. They just came out swinging, for no reason. You asked three questions, and I'm not going to call you a jerk for it. But just coming in here and making snide remarks? Absolutely being a jerk.

Now, your questions.

• No, I didn't use unit tests. I built this for my own personal use, and tested it on my system and my wife's with files in a variety of containers encoded at a variety of bitrates with a variety of codecs - random crap we had laying around our hard drives, from the internet, from Steam and OBS records, from our phone cameras. This isn't commercial software, I'm not asking for donations, and I made the license The Unlicense because I don't want money or credit for it. I shared it because I got it working and I thought other people might find it useful too. I'm not going to exhaustively test it like I'm taking subscriptions, I hate testing. When I come across an issue, I fix it, and that's the best I'm offering.

• It's FFMPEG in the backend, and it processes files sequentially. It encodes whatever you put in to HEVC MKV, or H264 MP4. You can set the QP settings for the quality you want. Explain where you expect inefficiency and how I can fix it, and I will.

• I'm pushing from a local repo to my Github where it runs a job to compile the binaries for each platform, and to Codeberg where it's not doing that (so I only have the compiled binaries at GitHub right now).

• What fixes did I apply? Many. Some examples would be not successfully detecting available hardware, showing all available encoders rather than only the ones that would work with available hardware, failing to build (so many build failures), window sizing issues, options not showing, hanging on starting a job because the ffmpeg command was getting mangled, failing to find ffmpeg, unable to add files, unable to probe files, packet counting not working so "best guess" settings would result in larger files than the originals, that sort of thing.

And incidentally, the fact that this is a personal project I shared in case someone might find it useful is another reason that coming in here and throwing shade is a shitty thing to do. This isn't Stack Overflow. If it's no use to you, move on. If you have constructive criticism, let's hear it. If you can do it better, go ahead. But why try to make me feel bad about it, because you don't like the way I built it? I used spaces instead of tabs too, go get the fucking pitchforks.

I was hoping to catch this before your replied, as I went and read the readme, then it made more sense. So I deleted my reply. But too late!

All good! I'm actually enjoying talking about this thing with people who want to know more so I don't mind at all ^_^

The cool thing is there isn’t much to put into a command that does stuff like this, unless you changing the FFMPEG parameters every time, but that would seem unlikely.

So actually, that's exactly the issue I was running into! I'd run a batch command on a whole folder full of videos, but a handful would already be well-encoded or at least they'd have a much MUCH lower bitrate, so I'd end up with mostly well-compressed files and a handful that looked like they went through a woodchipper. I wanted everything to be in the same codecs, in the same containers, at roughly the same quality (and playable on devices from around 2016 and newer) when it came out the other end, so I implemented a three-way decision based around the target bitrate you set and every file gets evaluated independently for which approach to use:

1. Above target → VBR re-encode: If a file's source bitrate is higher than the target (e.g. source is 8 Mbps and target is 4 Mbps), the video is re-encoded using variable bitrate mode aimed at the target, with a peak cap set to 150% of the target. This is the only case where the file actually gets compressed.

2. At or below target, same codec → stream copy: If the file is already at or below the target bitrate and it's already in the target codec (e.g. it's HEVC and you're encoding to HEVC), the video stream is copied bit-for-bit with -c:v copy. No re-encoding happens at all - the video passes through untouched. This is what prevents overcompression of files that are already well-compressed.

3. At or below target, different codec → quality-mode transcode: If the file is at or below the target but in a different codec (e.g. it's H.264 and you're encoding to HEVC), it can't be copied because the codec needs to change. In this case it's transcoded using either CQP (constant quantisation parameter) or CRF (constant rate factor) rather than VBR - so the encoder targets a quality level rather than a bitrate. This avoids the situation where VBR would try to force a 2 Mbps file "down" to a 4 Mbps target and potentially bloat it, or where the encoder wastes bits trying to hit a target that's higher than what the content needs.

There's also a post-encode size check as a safety net: if the output file ends up larger than the source (which can happen when a quality-mode transcode expands a very efficiently compressed source), HISTV deletes the output, remuxes the original source into the target container instead, and logs a warning. So even in the worst case, you never end up with a file bigger than what you started with which is much harder to claim with a raw CLI input. The audio side has a similar approach; each audio stream is independently compared against the audio cap, and streams already below the cap in the target codec are copied rather than re-encoded.

But yeah everything beyond that was bells and whistles to make it easier for people who aren't me to use it haha.

I am 100% looking for more stuff I can build - let's talk about it!