Skip to main content

Remove Silence from Media Files

Project description

Unsilence

Console Interface and Library to remove silent parts of a media file

MIT License Badge Github Action Badge Docker Cloud Build Status Documentation Build Status Codacy Badge Lines of code


Demo

Unedited (Before) Processed by Unsilence (After)
Unedited Demo Video Edited Demo Video
Time before edit: 0:09:45 (100%) Time after edit: 0:07:56 (81.2%), Difference: -0:01:50 (-18.8%)

The MIT Intro at the beginning is not included into the time, since I left it in to show the license of the videos.

These videos are from this online lecture:

Ana Bell, Eric Grimson, and John Guttag. 6.0001 Introduction to Computer Science and Programming in Python. Fall 2016. Massachusetts Institute of Technology: MIT OpenCourseWare, https://ocw.mit.edu. License: Creative Commons BY-NC-SA.

More Information about Licensing can be found in the Licensing Segment of this README.

Introduction

Unsilence is an open-source tool that removes silence from a media clip of your choice (audio, video).

You can use it to speed up videos without changing the audible speed, so you can understand everything, but get through a video faster.

Exemplary use cases

  • You are a college student and watch your lectures online (but have access to the video files). Instead of just increasing the playback speed to ~1.5x, you can remove the parts that do not contain any value, like your lecturer thinking or waiting for something. But instead of cutting out these silent parts, speeding them up by a different, much faster factor (think 6-8x) makes you still able to follow what is happening, so drawing or writing with no speech is sped up, which makes it far more pleasant to watch

  • You want a video editor that automatically cuts any time you talk (or make any sound). That could be useful for manual time lapses (you make a sound every time a short segment should be recorded), or for very fast jump cut videos with no manual editing required

  • You want to have some fun and remove all the audible parts from a video, leaving only the parts where nearly silent noises are in the video (breathing, writing, ...)

Communication

If you have any (technical) questions about unsilence or want to get community feedback, you can use the new GitHub Discussions Feature. To report a bug or suggest a new feature, create a new issue instead.

Usage Information

Unsilence can be used as a console line interface or as a python library, with which you can develop your own projects

Prerequisites

  • Python >= 3.7.0
  • pip (should be installed automatically with python, could be different on some linux distros)
  • ffmpeg >= 4.2.4

In order to see the fancy progress bar and other terminal styling on windows, you should use Windows Terminal.

Installation as command line interface (using pip and pipx)

# Installing pipx
pip install pipx

# Installing Unsilence as Command Line Software
pipx install unsilence

# If pipx asks you to, you also need to execute the following line
# as well as close and reopen your terminal window
pipx ensurepath

Installation as library (using pip)

# Installing Unsilence as Command Line Software
pip install unsilence

Installation as command line interface (from source)

# Clone the repository (stable branch)
git clone -b master https://github.com/lagmoellertim/unsilence.git unsilence

#Change Directory
cd unsilence

# Install pip packages
pip install -r requirements.txt
pip install pipx

# Install unsilence package
pipx install .

Installation as library (from source)

# Clone the repository (stable branch)
git clone -b master https://github.com/lagmoellertim/unsilence.git unsilence

#Change Directory
cd unsilence

# Install pip packages
pip install -r requirements.txt

# Install unsilence package
python3 setup.py install

Basic Command Line Usage

This generates a new file, where the silent parts are 6x as fast as before, the audible parts are the same speed as before

unsilence [input_file] [output_file]

You can change the speed of audible parts with -as [speed], the speed of silent parts with -ss [speed]

unsilence [input_file] [output_file] -as [speed] -ss [speed]

You can change the volume of audible parts with -av [volume], the volume of silent parts with -sv [volume]

unsilence [input_file] [output_file] -av [volume] -sv [volume]

To generate an audio only output file, you can add the -ao flag

unsilence [input_file] [output_file] -ao

To speed up the rendering process, you can increase the thread count using -t [threads]

unsilence [input_file] [output_file] -t [threads]

For many more settings, type -h or --help

unsilence --help

Basic Library Usage

Take a look at this example

Idea/Inspiration

For this project, I took inspiration from the CaryKH's video Jumpcutter. This project does not share any source code with his implementation, and is more optimized for my use case (fast and efficient lecture silence removal).

Contributing

If you are missing a feature or have new idea, go for it! That is what open-source is for! 😃

Author

Tim-Luca Lagmöller (@lagmoellertim)

Donations / Sponsors

I'm part of the official GitHub Sponsors program where you can support me on a monthly basis.

GitHub Sponsors

You can also contribute by buying me a coffee (this is a one-time donation).

Ko-Fi Sponsors

Thank you for your support!

License

The Code is licensed under the

MIT License

Copyright © 2019-present, Tim-Luca Lagmöller

All used videos are licensed under the

Creative Commons BY-NC-SA License

Have fun :tada:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

unsilence-1.0.9.tar.gz (20.3 kB view details)

Uploaded Source

Built Distribution

unsilence-1.0.9-py3-none-any.whl (23.0 kB view details)

Uploaded Python 3

File details

Details for the file unsilence-1.0.9.tar.gz.

File metadata

  • Download URL: unsilence-1.0.9.tar.gz
  • Upload date:
  • Size: 20.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.0

File hashes

Hashes for unsilence-1.0.9.tar.gz
Algorithm Hash digest
SHA256 201dac8235a00b8af5ee4ab64c49a7732cda79469955d2152586420c816aa55e
MD5 df4b4b26ee4cf81e894b0fd72750d869
BLAKE2b-256 3b360520a43b60cb3f79d0328ffbb6d9a708ac2b0307051c067242a41240ae34

See more details on using hashes here.

File details

Details for the file unsilence-1.0.9-py3-none-any.whl.

File metadata

  • Download URL: unsilence-1.0.9-py3-none-any.whl
  • Upload date:
  • Size: 23.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.0

File hashes

Hashes for unsilence-1.0.9-py3-none-any.whl
Algorithm Hash digest
SHA256 aee6367b8a016e60316642cfaf65d88ddf2d0246a1bf096d0a0d6d5394964fe1
MD5 3468ac503d3af8bd4cbe16e62ecd943f
BLAKE2b-256 c598155ec445e44a3235d4d3b0c774b2b6698ec924ef1f15bc9818577c94adac

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page