fx-upscale - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #golang #linux #nodejs #java #awesome-list #vue #security #mcp

fx-upscale

(★ 672)

Metal-powered video upscaling

File Explorer

Download Latest Version (.zip)

- - CI.yml
  - Release.yml
- FUNDING.yml
- - FXUpscale.swift
- - FrameChannel.swift
  - Upscaler.swift
  - UpscalingExportSession.swift
- - UpscalingTests.swift
.gitignore
.swiftformat
LICENSE
Package.resolved
Package.swift
README.md

# Installation Guide

1. Get the code

git clone https://github.com/finnvoor/fx-upscale

Downloads the entire project code from GitHub to your computer.

cd fx-upscale

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Homebrew A package manager for macOS/Linux.

brew install finnvoor/tools/fx-upscale

Installs the pre-built package via Homebrew — no source build required.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ↕️ fx-upscale
Metal-powered video upscaling

<p align="center">
<img src="https://github.com/finnvoor/fx-upscale/assets/8284016/c2ab0754-13f8-4fcc-a0f1-c10cf727af6d" width="800" />
</p>

> [!TIP]
> Looking for an app-based version of `fx-upscale`? Download [_Unsqueeze_](https://apps.apple.com/app/apple-store/id6475134617?pt=120542042&ct=github&mt=8) today! 🔥

## Usage
```
USAGE: fx-upscale <url> [--width <width>] [--height <height>]

ARGUMENTS:
  <url>                   The video file to upscale

OPTIONS:
  -w, --width <width>     The output file width
  -h, --height <height>   The output file height
  -h, --help              Show help information.
```
- If width and height are specified, they will be used for the output dimensions
- If only 1 of width or height is specified, the other will be inferred proportionally
- If neither width nor height is specified, the video will be upscaled by 2x

> [!NOTE]
> When upscaling videos to >4k, `.mp4` files will be converted to `.mov` and `h264` or `hevc` codecs will be re-encoded as `proRes422`.  This is due to the fact that macOS struggles to play back >4k video `h264` and `hevc` files, and `h264` and `hevc` codecs only support up to ~8k.  If you have a use case for creating >4k `h264`/`hevc` `.mp4`'s, please open an issue.

## Installation
### Homebrew
```bash
brew install finnvoor/tools/fx-upscale
```

### Mint
```bash
mint install finnvoor/fx-upscale
```

### Manual
Download the latest release from [releases](https://github.com/Finnvoor/MetalFXUpscale/releases).

#### `ffmpeg` upscaling vs `fx-upscale`
<img src="https://github.com/finnvoor/fx-upscale/assets/8284016/7ae867c2-caef-43d8-8fe3-7048c55f55bd" width="800" />