raycast / raycast/extensions

[Media Converter] Can't convert HEIC to PNG/JPG

Open
#23,637 7 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug Dont close extension extension: media-converter
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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.