Skip to main content

PyPI PyPI - License

Cutted

Cutted is an AI-powered audio editor you control with natural language.

  • Cut, trim, or adjust volume by typing what you want
  • Detect and remove silence or loud parts automatically
  • Transcribe audio (with Whisper)
  • Undo edits, export as MP3 or WAV

Install

  1. Make sure FFmpeg is installed.
  2. Install Cutted:
    pip install cutted
    
    With Whisper support:
    pip install cutted[whisper]
    

Usage

python -m cutted

Load an audio file, enter your command in plain English, and export your result.
You can also enable or disable chat history for smarter follow-up actions in the settings menu (gear icon).


Usage Examples

Basic Editing

  • Cut a segment:

    cut from 10 to 20
    

    Removes audio between 10s and 20s.

  • Remove multiple segments:

    cut from 5 to 7 and from 15 to 18
    
  • Change volume:

    make 0 to 5 seconds twice as loud
    

    or

    reduce volume from 10 to 12 by half
    
  • Remove silence:

    remove all silent parts
    

    Note: Removing silence is experimental and can be buggy or produce bad results in some cases.

  • Undo last edit:
    Click the "Undo" button.

  • Export your result:
    Click the "Export" button and choose MP3 or WAV.

Advanced: Using Whisper Transcription

If you install with Whisper support and enable "Send transcript to Gemini" in the UI, you can use commands like:

  • Cut by word or sentence:
    cut when I say the word hello
    
    or
    cut the sentence "welcome to the show"
    

    This uses Whisper to transcribe your audio and allows precise editing based on spoken words or phrases.

Audio-to-Gemini (Experimental)

If you enable "Send audio to Gemini" (checkbox), you can also use word-based commands, but accuracy is much lower compared to using Whisper.


Gemini API Key

Set your Gemini API key as an environment variable before running Cutted:

Linux/macOS:

export GEMINI_API_KEY="your-gemini-api-key"

Windows (Command Prompt):

set GEMINI_API_KEY=your-gemini-api-key

Windows (PowerShell):

$env:GEMINI_API_KEY="your-gemini-api-key"

Metadata

Release files for cutted 0.4.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cutted 0.4.4
File Size Uploaded
cutted-0.4.4.tar.gz 24.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for cutted 0.4.4
File Interpreter ABI Platform
cutted-0.4.4-py3-none-any.whl Python 3 none any Details

Total release size: 47.9 kB

Release files / cutted-0.4.4.tar.gz

Download URL cutted-0.4.4.tar.gz
Size 24.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c3fad0ccc686915356cde175b6abb791503965be265e5619ddff6b3476a12d94
BLAKE2b-256 checksum
How to use checksums
ff5e020225647b2da056736e2ebe806fb4c2bca8fcf5691b7dad84daff344c31
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.5

Release files / cutted-0.4.4-py3-none-any.whl

Download URL cutted-0.4.4-py3-none-any.whl
Size 23.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
62f44084421688ccd2ee52e9869b107e7d287e165ee5ab82b6b8581e12993591
BLAKE2b-256 checksum
How to use checksums
0bfd9a4fe7137b64c98ee30981e5d583fadd6f8c5258db43f1c9e54bf3ab3c02
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

0.4.4 This release

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.2

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page