Skip to main content

​
Quick Start

Get started with Convert to it! in under a minute. No account, no installation, just open and convert.

​
Using the Web App

1

Open Convert to it!

Navigate to convert.to.it in your web browser.
For best performance, use a modern browser like Chrome, Firefox, or Edge. The tool uses WebAssembly which requires recent browser versions.
2

Add Your File

You have two options:Option 1: Click to browseClick the big blue box labeled “Click to add your file” to open the file picker.Option 2: Drag and dropSimply drag your file from your file explorer and drop it anywhere on the window.
<!-- The file input area from index.html -->
<div id="file-area">
  <h2>Click to add your file</h2>
  <p id="drop-hint-text">or drag and drop it here</p>
</div>
3

Select Input Format

The tool will automatically detect your file’s format based on:
  • File extension
  • MIME type
  • Binary signatures
If the format wasn’t detected automatically, you can:
  • Search for your format in the “Convert from:” list
  • Scroll through available input formats
If your format isn’t listed, it may not be supported yet. Check the GitHub issues or consider contributing support for it.
4

Choose Output Format

Select your desired output format from the “Convert to:” list.On desktop: The output format list is on the right side.On mobile: The output format list is below the input format.Use the search box to quickly find specific formats:
<input type="text" id="search-to" class="search" placeholder="Search">
Not all conversions are direct. Convert to it! uses a smart graph traversal algorithm to find conversion paths, even chaining multiple converters if needed.
5

Convert!

Click the Convert button at the bottom of the page.The tool will:
  1. Load necessary conversion tools (FFmpeg, ImageMagick, etc.)
  2. Process your file entirely in your browser
  3. Generate the output file
First-time conversions may take longer as WebAssembly modules are loaded and cached. Subsequent conversions will be much faster.
6

Download Your File

Once conversion completes, your browser will automatically download the converted file.The output filename will be your original filename with the new extension.

​
Example Conversions

Here are some common conversion scenarios:

​
Image Format Conversion

1. Upload: photo.png
2. From: PNG (auto-detected)
3. To: JPEG
4. Download: photo.jpg

​
Video Conversion

AVI to MP4
1. Upload: movie.avi
2. From: AVI (auto-detected)
3. To: MP4
4. Download: movie.mp4

​
Document Conversion

Markdown to PDF
1. Upload: document.md
2. From: Markdown (auto-detected)
3. To: PDF
4. Download: document.pdf

​
Cross-Medium Conversion

Video to PDF
1. Upload: clip.mp4
2. From: MP4 (auto-detected)
3. To: PDF (extracts frames)
4. Download: clip.pdf

​
Advanced Mode

Click the Advanced mode button in the side panel to access additional options: 
<div id="side-panel">
  <button id="mode-button">Advanced mode</button>
</div>
Advanced mode provides:
  • Additional conversion parameters
  • Batch processing options
  • Format-specific settings

​
Tips for Best Results

Be Patient

Complex conversions (especially video) can take time. The tool will show progress indicators.

Try Different Paths

If a direct conversion doesn’t work as expected, try converting to an intermediate format first.

Check File Size

Very large files may take significant time to process since everything runs in your browser.

Use Modern Browsers

Chrome, Firefox, and Edge provide the best WebAssembly performance.

​
Troubleshooting

​
Format Not Auto-Detected

If your input format wasn’t automatically detected:
  1. Check if the file extension is correct
  2. Try renaming the file with the correct extension
  3. Manually select the format from the “Convert from:” list

​
Conversion Failed

If a conversion fails:
  1. Check the browser console for error messages
  2. Try a different output format
  3. Ensure your file isn’t corrupted
  4. Try converting to an intermediate format first

​
Slow Performance

If conversions are slow:
  1. Close other browser tabs to free up memory
  2. Wait for initial tool loading (only happens once)
  3. Consider using the desktop app for better performance

​
Output Not as Expected

Remember: Convert to it! will always try to produce some output, even for unusual conversion pairs. The result may not always be what you expected, but it will attempt to extract or transform the data in a meaningful way.

​
Self-Hosting

Want to run Convert to it! locally? See the deployment guide in the README.

​
Local Development

# Clone with submodules
git clone --recursive https://github.com/p2r3/convert

# Install Bun
curl -fsSL https://bun.sh/install | bash

# Install dependencies
bun install

# Start development server
bunx vite

​
Docker Deployment

# Using prebuilt image
docker compose -f docker/docker-compose.yml up -d

# Access at http://localhost:8080/convert/

​
Next Steps

Explore Features

Learn about all the capabilities of Convert to it!

Contribute

Add support for new formats or improve existing handlers

Build docs developers (and LLMs) love

Get started for freeTalk to us