Converter
Converts files between formats: video, audio, images, PDF, documents, e-books, archives.
Converter
Answer in the language of the person's message (a request in Russian gets the whole answer in Russian), briefly. When the request names a file and what it should become, start at once and ask nothing.
A conversion is done only by running a program on the person's own file. If you cannot run commands or code on that file here, say so in one sentence, say that the skill works in an assistant that runs commands on the person's computer, and stop. Never make the result with an image or text generator, never redraw, retype or retell the content instead: that is a new picture or text, not the person's file converted.
Turn a file into the form the person needs with free command-line tools, then
check the result before saying it is done. scripts/av.py does the fragile
video decisions; everything else is one command from the lists below.
scripts/av.py lives in this skill's own folder, the folder that holds this
file, not in the person's folder. Call it by its full path, for example
python3 /path/to/converter/scripts/av.py info video.mkv; below it is written
short as av.py. It needs Python 3 and ffmpeg. Some copies of this skill
come without the script (directories that accept text only): then do the
same with the ffprobe and ffmpeg commands in «Video without av.py».
Where the result goes
- On the person's computer: next to the original, under a new name, unless they said otherwise.
- In a chat app's sandbox (the file was uploaded; the person's disk is out of reach): give the result as a file to download. Do not ask where to save it.
Ask only when the request leaves the file or the target unclear (a bare «/converter», «make it better»): one short question, in the person's language. Keep what they answer for the rest of the conversation; store it nowhere else unless the person asks.
Every job
- Find the input file: in the current folder first; if it is not there, ask for its path rather than search the whole disk. Never change, move or overwrite it, even when the request says «fix this file» or «make it searchable»: the result is always a new file beside it.
- Look at it first. Media:
av.py info FILE. Anything else:file FILE; PDF:pdfinfo FILE. - Pick the tool from the table. Copy instead of re-encoding whenever the target format allows it: copying is fast and loses nothing.
- Write a new file: the same name with the new extension. If that name is taken, add « (2)», « (3)» before the extension.
- Check the result (section «Check»). Fix and check again until it passes.
- Delete the temporary files you made (test frames, copies, logs).
- Report in two or three lines: where the file is, its size, what changed, and anything that was lost or dropped.
A request with two possible readings: take the likelier one and say which in one line. Ask only what changes the result and cannot be guessed.
Usual meanings:
- «for a phone», «won't play», «for the TV», «for the web»: an mp4 that plays
everywhere,
av.py play. - «for email»: under 25 MB. «for a messenger»: ask the limit if the file is large; many accept up to 2 GB.
- «smaller», «compress»: keep the format and lower the quality a little; give the old and new sizes.
Tools
| Files | Tool | Check that it is there |
|---|---|---|
| video, audio, subtitles, GIF | ffmpeg | ffmpeg -version |
| photos and pictures | ImageMagick 7 | magick -version |
| SVG to picture | resvg | resvg --version |
| qpdf, poppler, Ghostscript, img2pdf, ocrmypdf | qpdf --version, pdfinfo -v, gs -v | |
| DjVu | djvulibre | ddjvu --help |
| Word, Excel, PowerPoint, OpenDocument | LibreOffice | soffice --version |
| Markdown, HTML, docx, epub | pandoc | pandoc --version |
| e-books (fb2, epub, mobi, azw3) | calibre | ebook-convert --version |
| archives (zip, 7z, rar, iso) | 7-Zip | 7zz or 7z |
| text encodings | uchardet, iconv | uchardet --version |
| json, yaml, xml, csv | yq (mikefarah, v4) | yq --version |
When a tool is missing on the person's computer, name it, give the install
command for this system and wait. Install only after the person agrees. In
a chat app's sandbox, which is thrown away with the chat, install what the
job needs (pip install …) without asking, and say in the report what was
installed.
- macOS (Homebrew):
brew install ffmpeg imagemagick resvg qpdf poppler ghostscript img2pdf ocrmypdf tesseract-lang djvulibre pandoc sevenzip uchardet yq exiftoolandbrew install --cask libreoffice calibre - Debian, Ubuntu:
sudo apt install ffmpeg imagemagick resvg qpdf poppler-utils ghostscript img2pdf ocrmypdf tesseract-ocr-all djvulibre-bin pandoc 7zip uchardet libimage-exiftool-perl libreoffice calibre(yq: the binary from github.com/mikefarah/yq) - Windows:
winget install Gyan.FFmpeg ImageMagick.ImageMagick JohnMacFarlane.Pandoc 7zip.7zip TheDocumentFoundation.LibreOffice calibre.calibre MikeFarah.yq
In a chat app with code execution, work on the uploaded file inside the sandbox and hand the result back as a download. Sandboxes often lack ffmpeg or LibreOffice; Python libraries (Pillow, pypdf) may still cover pictures and PDFs. If the job cannot be done there, say so plainly.
Video and audio
- Plays everywhere (phones, computers, TVs, browsers):
av.py play IN OUT.mp4. It copies H.264 and AAC/MP3 as they are, re-encodes the rest to H.264 + AAC, keeps every audio track with its language and turns text subtitles into mp4 subtitles.--keep-hevckeeps HEVC (smaller, HDR kept; plays on Apple devices and most new phones).--crf 20for better quality,--crf 26for a smaller file. - Fit a size:
av.py size 25M IN OUT.mp4(two passes; lowers the resolution when the size leaves too few bits for it). - Only another container:
ffmpeg -i IN.mkv -map 0 -c copy -c:s mov_text OUT.mp4. If it fails, the codecs don't fit mp4: useav.py play. The copy plays everywhere only ifav.py infosaid so for every track. - Cut without re-encoding:
ffmpeg -ss 00:01:00 -to 00:01:30 -i IN -c copy OUT(starts at the keyframe before 1:00; for an exact start leave out-c copy). - Join files of the same format: a list file with lines
file '/full/path', thenffmpeg -f concat -safe 0 -i list.txt -c copy OUT. - Sound out of a video:
ffmpeg -i IN -vn -c:a copy OUT.m4awhen the audio is AAC; otherwise-c:a aac -b:a 192k OUT.m4a, or-c:a libmp3lame -q:a 2 OUT.mp3. - Audio format:
ffmpeg -i IN.flac -c:a libmp3lame -q:a 2 OUT.mp3;-c:a flac OUT.flac;-c:a pcm_s16le OUT.wav. - GIF from 5 seconds at 0:10:
ffmpeg -ss 10 -t 5 -i IN -vf "fps=12,scale=480:-1:flags=lanczos,split[a][b];[a]palettegen=stats_mode=diff[p];[b][p]paletteuse=dither=sierra2_4a" OUT.gif. An animated WebP looks the same and is about ten times smaller:magick OUT.gif -quality 70 OUT.webp. - Rotate without re-encoding (ffmpeg 7 or newer):
ffmpeg -display_rotation 90 -i IN -map 0 -c copy OUT. - Burn subtitles into the picture:
ffmpeg -i IN -vf "subtitles=SUBS.srt" -c:a copy OUT.mp4. - Even loudness for speech:
ffmpeg -i IN -af loudnorm=I=-16:TP=-1.5:LRA=11 OUT.
Video without av.py
The same decisions by hand, for a copy of the skill without the script.
- Look:
ffprobe -v error -show_entries stream=index,codec_type,codec_name,profile,pix_fmt,width,height,avg_frame_rate:stream_tags=language -of compact INandffprobe -v error -show_entries format=duration -of csv=p=0 IN. - Plays everywhere: video may be copied only if it is h264 with pix_fmt
yuv420p and profile Baseline, Main or High; audio only if aac or mp3.
Everything else is re-encoded:
ffmpeg -i IN -map 0:v:0 -map 0:a -c:v libx264 -preset medium -crf 23 -pix_fmt yuv420p -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" -c:a aac -b:a 160k -movflags +faststart OUT.mp4(-c:v copyor-c:a copyinstead where the stream may be copied). Text subtitles (subrip, ass, webvtt): add-map 0:s -c:s mov_text; picture subtitles (hdmv_pgs_subtitle, dvd_subtitle) cannot go in, leave them out and say so. Languages:-metadata:s:a:0 language=rusand so on, three letters. - Fit a size: video kbit/s = size in MB × 8000 ÷ seconds × 0.96 − 128.
If that is below width × height × fps × 0.04 ÷ 1000, add
-vf scale=-2:720(then 540, 480, 360) and compute again. Two passes:ffmpeg -y -i IN -c:v libx264 -preset slow -b:v VIDEOk -pass 1 -an -f mp4 /dev/null(NULinstead of/dev/nullon Windows), thenffmpeg -i IN -c:v libx264 -preset slow -b:v VIDEOk -pass 2 -c:a aac -b:a 128k OUT.mp4. Too big still: lower VIDEO by the overshoot and run both passes again. Delete theffmpeg2pass*log files afterwards. - Check: the durations of IN and OUT (step 1) differ by at most half a second, and OUT has as many video and audio streams as were kept.
Pictures
- HEIC, PNG, WebP, AVIF to JPEG:
magick IN -quality 90 OUT.jpg. To WebP:-quality 85 OUT.webp; to AVIF:-quality 60 OUT.avif. - Longest side 2048 pixels:
magick IN -resize 2048x2048\> OUT(\>only shrinks, never enlarges). - Many files:
magick mogrify -path OUTDIR -format jpg -quality 90 *.heic. - SVG to PNG:
resvg -w 1024 IN.svg OUT.png. Icon:magick IN.png -define icon:auto-resize=256,64,48,32,16 OUT.ico. - Remove location before sending to someone, on the copy:
exiftool -gps:all= -xmp:geotag= -overwrite_original COPY.jpg. - macOS also has
sips -s format jpeg IN.heic --out OUT.jpgbuilt in. - HEIC where ImageMagick or ffmpeg fail (a chat sandbox's libheif may decode
only AV1):
pip install pillow-heif, then in Pythonfrom PIL import Image; from pillow_heif import register_heif_opener; register_heif_opener(); im = Image.open("IN.heic"); im.save("OUT.jpg", "JPEG", quality=90, exif=im.info.get("exif")). Size and EXIF stay; the picture comes out turned the right way.
PDF and scans
- Merge:
qpdf --empty --pages a.pdf b.pdf -- OUT.pdf. Pages 3 to 7:qpdf IN.pdf --pages . 3-7 -- OUT.pdf. Rotate page 1:qpdf IN.pdf OUT.pdf --rotate=+90:1. - To pictures:
pdftoppm -r 150 -jpeg IN.pdf page. To text:pdftotext -layout IN.pdf OUT.txt. - Pictures to PDF:
img2pdf --pagesize A4 --fit into *.jpg -o OUT.pdf. - Searchable scan:
ocrmypdf -l eng+rus IN.pdf OUT.pdf. Choose the languages by looking at a page first (render one withpdftoppm); installed ones:tesseract --list-langs. - Smaller:
gs -sDEVICE=pdfwrite -dPDFSETTINGS=/ebook -dSAFER -dBATCH -dNOPAUSE -sOutputFile=OUT.pdf IN.pdf. - DjVu to PDF:
ddjvu -format=pdf -quality=60 IN.djvu OUT.pdf(without-qualitya page takes megabytes), thenocrmypdfif the text should be searchable. Text the DjVu already has:djvutxt IN.djvu.
Documents and books
- Office to PDF:
soffice --headless --convert-to pdf --outdir OUTDIR IN.docx(also xlsx, pptx, odt, doc, rtf). docx to odt or back:--convert-to odt. - Markdown to Word, HTML, e-book:
pandoc IN.md -o OUT.docx(or.html,.epub,.odt). To PDF:pandoc IN.md -o OUT.docx, then LibreOffice to PDF. - E-books:
ebook-convert IN.fb2 OUT.epub(also epub, mobi, azw3, pdf, txt, docx).
Archives, text, data
- Unpack:
7zz x -oOUTDIR IN(7zwhere only that one is installed). Zip a folder:7zz a -tzip OUT.zip FOLDER(no hidden macOS files inside). - Garbled letters:
uchardet IN.txtnames the encoding, theniconv -f WINDOWS-1251 -t UTF-8 IN.txt > OUT.txt(use the name it printed). - Data:
yq -o json IN.yaml > OUT.json;yq -p csv -o json IN.csv;yq -p xml -o yaml IN.xml.
Check
- Video and audio:
av.py check IN OUT(duration and track counts; without the script, step 4 of «Video without av.py»). When the picture was changed (rotation, size, subtitles burned), look at one frame:ffmpeg -ss 2 -i OUT -frames:v 1 frame.jpg. - Pictures:
magick identify OUT(size, format); look at it once. - PDF:
pdfinfo OUT.pdf(pages as expected);pdftotext OUT.pdf - | headfor text; render one page to look at. - Documents and books: open or render the first page; the text is there.
- Archives:
7zz t OUT; text files:head OUT. - A smaller file must be smaller: compare sizes, keep the original if it is not.
Known mistakes
- HEIC in a chat sandbox: ImageMagick, ffmpeg and OpenCV failed there (libheif with only the AV1 decoder). Use pillow-heif (section «Pictures»).
- In a chat app, «convert this photo to JPEG» can start the app's image generator: it redraws the picture (another size, an invented paper texture, changed details) and calls it a JPEG. That is not a conversion; never offer it as one. Compare the result's size with the original.
- Overwriting the input with the output, or using
mogrifywithout-path: it changes the originals. - A failed ffmpeg run can leave an empty or half-written output file. Delete it before trying again; never hand it over.
- VP9, AV1, Opus or FLAC inside mp4 or mkv often won't play on phones, TVs or
in QuickTime even when a computer player plays them.
av.py playhandles it. - HEVC in mp4 must be tagged
hvc1, nothev1, or iPhones refuse it. - mp4 keeps only three-letter language codes:
ruvanishes,russtays. - Picture subtitles (PGS, DVD) cannot go into mp4: burn them in or drop them.
- The container's duration can be wrong (chapters past the end); measure the longest audio or video stream instead.
- Joining mp3 files with
-c copybreaks timestamps: re-encode. - In loops, give ffmpeg
-nostdin, or it eats the loop's input and files are cut short. - Homebrew's
ffmpegon macOS has no libass (burning subtitles) and no libwebp;brew install ffmpeg-fullhas both (its path:$(brew --prefix ffmpeg-full)/bin/ffmpeg). Check:ffmpeg -filters | grep subtitles. - Re-encoding an already compressed web video can make it bigger. Compare sizes.
- Ghostscript can make a text PDF bigger while it shrinks a scan. Compare and keep the smaller.
- Pictures with an orientation tag: some tools rotate the pixels, others keep
the tag. Before
img2pdf, runmagick IN -auto-orient OUTor a portrait photo lands sideways on the page. file -Ireports Windows-1251 Cyrillic as «iso-8859-1». Trustuchardet.- Two different programs are called
yq. The commands here are for mikefarah's v4; Debian'syqpackage is the other one. - OCR has no models for old spelling (pre-1918 Russian, for example): expect noise and say so.
- Downloads
- 70All time
- Security audit
- Pass
- Last updated
- 1d ago
- Current version
- v0.2.2
- License
- MIT-0
