Skip to content

A command-line tool to slice videos for social-media stories

License

Notifications You must be signed in to change notification settings

myTerminal/story-slicer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

story-slicer

Built with Lisp License
ko-fi

A command-line tool to slice videos for social-media stories

Installation

There are a few different ways to get story-slicer.

Compile from source

# Clone project to the local workspace
git clone https://github.com/myTerminal/story-slicer.git

# Switch to the project directory
cd story-slicer

# Install with `make`
make install

Through a package manager

story-slicer will soon be available to install from your operating system's package manager.

How to Use

A simple way to use story-slicer is to run it in a command-line terminal passing in the path of the video file to be sliced.

story-slicer ~/Videos/input.mp4

The above command would create slices of the video and place them within the current directory. You can optionally also specify the output directory where you expect the slices to be placed.

story-slicer ~/Videos/input.mp4 ~/Downloads

By default, the video file input.mp4 is split into several videos of 30 seconds in length and placed in the specified output directory. You can also optionally specify the length of the individual slices as the second argument to the command.

story-slicer ~/Videos/input.mp4 ~/Downloads 60

The above command would split the video into several videos of 60 seconds each.

One can also provide a start offset, which is the number of seconds to ignore from the input video. So, the above command would turn into:

story-slicer ~/Videos/input.mp4 ~/Downloads 60 15

and it would ignore the first 15 seconds of the input video.

Just the way you can skip a part of the video from the start, you can also omit a part towards the end.

story-slicer ~/Videos/input.mp4 ~/Downloads 60 15 250

The above command splits the input video input.mp4 into slices that are 60 seconds long, but skips the first 15 seconds of the input video, and ends the splitting process at 250 seconds.

Further help with commands

To learn more about usage, refer to manpage:

man story-slicer

Updating

In order to update story-slicer, simply run:

story-slicer-update

Uninstalling

In order to uninstall story-slicer, simply run:

story-slicer-uninstall

External Dependencies

Being written with Common Lisp, story-slicer depends on SBCL. In most cases, it will be automatically installed while generating the binary, but if it doesn't please install it before running the installation.

The other required programs are as follows:

To-do

  • Implement installation of ffmpeg automatically
  • Implement detection of file extension
  • Implement padding of slice numbers

About

A command-line tool to slice videos for social-media stories

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages