⭐ Support AutoShorts

AutoShorts is a local-first desktop application for turning long-form video or audio recordings into high-impact, vertical short-form clip candidates (9:16 portrait) with AI-powered viral moment ranking.

This repository implements the desktop app foundation using Tauri 2 + React + TSX + Rust + SQLite.

• Dynamic Multi-LLM Support: Supports both DeepSeek (default) and Claude (anthropic) for viral moment detection and hooks analysis.
• Automated Pipeline: Imports media, extracts audio, transcribes using Deepgram, and automatically analyzes and ranks moments in a single automated chain.
• Local SQLite Storage: Saves transcripts, candidates, custom names, and rendering data locally.
• Native Project Manager: Create, open, rename, and delete projects from the dashboard.
• Portrait Auto-Cropping: Automatically center-crops landscape videos to vertical H.264 portrait clips using native ffmpeg integration.
• Key Warnings: Built-in visual warnings that identify missing environment variables and prompt you directly in the UI.

To run the application, FFmpeg & FFprobe must be installed and available on your system PATH to handle cropping, audio extraction, and dynamic captions:

• macOS: Install using Homebrew:

  brew install ffmpeg

  Note: To ensure full captions rendering support, if standard Homebrew FFmpeg lacks drawtext/subtitles filters, tap and install the homebrew-ffmpeg formula:

  brew tap homebrew-ffmpeg/ffmpeg
  brew install homebrew-ffmpeg/ffmpeg/ffmpeg

• Windows: Install using Winget (in PowerShell):

  winget install Gyan.FFmpeg

  (Or download the release build from gyan.dev and add it to your system PATH environment variables).
• Linux: Install via your native package manager:

  sudo apt install ffmpeg      # Debian/Ubuntu
  sudo pacman -S ffmpeg        # Arch Linux
  sudo dnf install ffmpeg      # Fedora

Download the correct package matching your system from the latest GitHub Releases.

1. Download:
   • Apple Silicon (M1/M2/M3): Select the aarch64.dmg package.
   • Intel Mac: Select the x64.dmg package.
2. Install: Double-click the .dmg file and drag AutoShorts to your Applications folder.
3. Bypass Gatekeeper (For unsigned local builds):
   • Right-click AutoShorts.app in Finder, select Open, and click Open in the warning dialog.
   • Alternatively, run this command in Terminal:

     xattr -cr /Applications/AutoShorts.app

1. Download: Select the .msi (installer) or .exe (portable executable) package.
2. Install: Double-click the .msi file to run the setup wizard.
3. SmartScreen Bypass: Since the package is self-signed, Windows SmartScreen may show a warning. Click "More Info" in the window and choose "Run anyway".

1. Download: Select the .deb (Debian/Ubuntu) or .AppImage (universal portable binary).
2. Install .deb:

   sudo dpkg -i autoshorts_*.deb

3. Run .AppImage: Make it executable and launch it:

   chmod +x autoshorts_*.AppImage
   ./autoshorts_*.AppImage

Once installed, open the application and click API Settings in the top bar:

1. Paste your API keys for Deepgram (transcription) and Claude and/or DeepSeek (viral candidate moments).
2. The UI will show a green (Active) badge next to your active LLM and notify you if credentials are missing.

Copy .env.example to .env in the root folder:

cp .env.example .env

Fill in your API Keys:

DEEPGRAM_API_KEY=your-deepgram-api-key
DEEPSEEK_API_KEY=your-deepseek-api-key
ANTHROPIC_API_KEY=your-anthropic-api-key

# Choose your default AI analysis provider ("deepseek" or "claude")
LLM_PROVIDER=deepseek

To start the live-reloaded frontend and backend development shell:

npm install
npm run tauri:dev

To build and package the native macOS app bundle (.app and .dmg installer):

npm run tauri:build

The output installers will be built under src-tauri/target/release/bundle/.

If AutoShorts helps you create content faster, consider supporting its development.

Your support helps fund new features, bug fixes, and ongoing improvements.

👉 https://polar.sh/checkout/polar_c_eZfQSAesVTAhaNyDtC8GnzySlU1yqflU62wwg2EfFDF