[Media Converter] Can't convert HEIC to PNG/JPG
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 7.8k
- Forks
- 6.9k
- Avg merge
- 2d 6h
- Merged PRs (30d)
- 442
Description
Extension
https://www.raycast.com/leandro.maia/media-converter
Raycast Version
v0.39.1.0
macOS Version
Windows 11 25H2
Description
The Raycast Media Converter extension fails to convert HEIC images to PNG or JPG on Windows, even when a custom FFmpeg binary with libheif support is explicitly configured.
The same FFmpeg binary successfully converts the same HEIC file when executed manually via command line, which indicates the issue lies in how Raycast invokes FFmpeg or constructs the command, not in FFmpeg itself.
Additional Notes:
Manual conversion using the same FFmpeg binary works without issue:
ffmpeg -i "C:\Main Storage\Downloads\IMG_7288.HEIC" -frames:v 1 "C:\Main Storage\Downloads\IMG_7288.png"
This confirms:
- FFmpeg is correctly installed.
- HEIC decoding via libheif works.
- The input file is valid.
- The -compression_level flag is either invalid or ignored for PNG in FFmpeg and may be causing the failure.
- The issue appears to stem from Raycast’s command construction or execution context on Windows.
Steps To Reproduce
Install FFmpeg full build with libheif enabled (verified working).
Configure Raycast Media Converter to use a custom FFmpeg binary:
C:\ffmpeg\bin\ffmpeg.exe
Attempt to convert a .HEIC file to .png or .jpg using the Media Converter extension.
Observe that conversion fails or produces no output.
Current Behaviour
Conversion fails silently or does not produce the expected output.
Raycast attempts to execute the following command internally:
"C:\ffmpeg\bin\ffmpeg.exe" -i "C:\Main Storage\Downloads\IMG_7288.HEIC" -compression_level 100 -y "C:\Main Storage\Downloads\IMG_7288.png"
Even when the command is executed, the output image is not generated.
No meaningful error message is surfaced to the user.
Expected Behaviour
Raycast should successfully convert HEIC files to PNG or JPG when:
-
A valid FFmpeg binary with HEIC (libheif) support is provided.
-
The same conversion works via manual FFmpeg invocation.
Raycast should:
-
Use valid FFmpeg arguments for the target format.
-
Execute FFmpeg in a way that matches standard Windows shell behavior.
-
Surface FFmpeg stderr output when conversion fails.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
No repository file or test is named in the report. Start by reproducing the Media Converter extension's Windows invocation and compare it with the working manual FFmpeg command shown; done means HEIC files convert to PNG or JPG and FFmpeg stderr is surfaced when conversion fails.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- desktop, tooling
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100