FIELD GUIDE / 001

Getting started with Honeymelon

Honeymelon is a local desktop media converter. The browser converter is planned, not available.

1. Choose a release

Start with the published stable desktop release. The 3.0 beta is unsigned and may trigger operating-system trust warnings.

Compare stable and beta downloads

2. Verify and install

Download only from the official GitHub Releases page. Compare the downloaded file against its published SHA-256 checksum before installing. Do not bypass a warning for a file whose origin or hash you cannot verify.

The 3.0 beta publishes SHA256SUMS. Older stable releases may not include it; if your release has no published checksum, this check is not available. Do not substitute a checksum from another version.

Keep the release's SHA256SUMS file beside your download. In a terminal, replace PACKAGE with the exact downloaded filename and compare the full 64-character result with the matching entry in SHA256SUMS.

macOS Terminal
shasum -a 256 PACKAGE
Linux terminal
sha256sum PACKAGE
Windows PowerShell
Get-FileHash -Algorithm SHA256 .\PACKAGE

A checksum detects a changed or incomplete download; it does not replace publisher signing or notarization. If it does not match, delete the download and report the discrepancy before installing.

3. Convert a local file

Open Honeymelon, select a source file, choose an output supported by your installed version, and select a destination. Available formats and controls vary by platform and encoder. Keep the original until you have checked the result.

4. Troubleshoot or contribute

When reporting a problem, include your Honeymelon version, operating system, input and output formats, expected result, actual result, and steps to reproduce. Never attach private media to a public issue.

Report an issue on GitHub · Contributor guide

Frequently asked questions

Do I need an account?

No account is required for the desktop conversion workflow.

Does Honeymelon upload my files?

The desktop conversion workflow processes source media locally rather than uploading it to a Honeymelon conversion server. External websites linked from this site have their own policies.

Can I use Honeymelon offline?

Desktop media conversion runs locally. Downloading the application, visiting documentation and checking GitHub releases require a network connection. Keep the installed app and required media on your device.

Why did a conversion fail or change the result?

Check the output format, available disk space and release notes. Unsupported codecs, damaged inputs and protected media can prevent conversion. Lossy formats may change quality; compare the result before removing the source.

Can I convert files in my browser?

Not yet. Browser conversion is a roadmap item, and supported codecs may differ from desktop when it arrives.