https://github.com/slothsoft/mp4-spliterator
An application for splitting MP4 files into chapters.
https://github.com/slothsoft/mp4-spliterator
Last synced: 9 days ago
JSON representation
An application for splitting MP4 files into chapters.
- Host: GitHub
- URL: https://github.com/slothsoft/mp4-spliterator
- Owner: slothsoft
- License: mit
- Created: 2020-02-23T17:55:11.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-04-08T21:21:41.000Z (about 6 years ago)
- Last Synced: 2026-01-13T19:48:10.481Z (5 months ago)
- Language: Java
- Homepage: http://slothsoft.de
- Size: 1.2 MB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MP4 Spliterator
[](http://opensource.org/licenses/MIT) [](https://travis-ci.com/slothsoft/mp4-spliterator)
- **Author:** [Stef Schulz](mailto:s.schulz@slothsoft.de)
- **Repository:**
- **Open Issues:**
- **User Manual:** [Hosted on GitHub](https://slothsoft.github.io/mp4-spliterator/)
An application for splitting MP4 files into chapters:
**Content of this ReadMe:**
- [Getting Started](#getting-started)
- [Features](#features)
- [Versions](#versions)
- [Developer Guide](#developer-guide)
- [Third Party Libraries](#third-party-libraries)
- [Icons](#icons)
- [MP4](#mp4)
- [License](#license)
## Getting Started
Prerequisites
You need at least an installed Java 8 or above to run the code. You can download it from
java.com.
Installing
Just download the last release and extract it in a folder of your choice, then double click the EXE file.
One of the first things the application does is to download ffmpeg. You
can speed up this progress by downloading it yourself and entering the location of the downloaded file in
the init wizard.
### Using the Application
Splitting an MP4 into chapters is an easy process which can be done in very
little clicks:
- 1st a) Double click on a video in the
Video Folder. - 1st b) Or open a video directly via the menu File →
Open Video. - 2nd The video will be opened in a separate section where you can check and uncheck the chapters.
- 3rd Click
Export Chapters Separately and choose a folder. The chapters will be exported into this folder.
*(More information can be found in the [user manual](https://slothsoft.github.io/mp4-spliterator/).)*
## Features
If something is missing, request it via [a new issue](https://github.com/slothsoft/mp4-spliterator/issues/new).
## Versions
| Version | Issues | Changes | Download |
| ------------- | ------ | ------------- | ------------- |
| Future | [Issues](https://github.com/slothsoft/mp4-spliterator/milestone/4) | | |
| 1.2.0 | [Issues](https://github.com/slothsoft/mp4-spliterator/milestone/5?closed=1) | Linux & more control | [Download](https://github.com/slothsoft/mp4-spliterator/releases/tag/1.2.0)
| 1.1.1 | [Issues](https://github.com/slothsoft/mp4-spliterator/milestone/3?closed=1) | Bugfixes | [Download](https://github.com/slothsoft/mp4-spliterator/releases/tag/1.1.1)
| 1.1.0 | [Issues](https://github.com/slothsoft/mp4-spliterator/milestone/2?closed=1) | Chapter merging | [Download](https://github.com/slothsoft/mp4-spliterator/releases/tag/1.1.0)
| 1.0.0 | [Issues](https://github.com/slothsoft/mp4-spliterator/milestone/1?closed=1) | First prototype | [Download](https://github.com/slothsoft/mp4-spliterator/releases/tag/1.0.0)
## Developer Guide
To start this project in your Eclipse, do:
1. Clone this repository
1. Call `mvn install -Pstart` on _maven-p2/pom.xml_ (_Start P2 Repo.launch_) to start a P2 repository locally
1. To start the application from **Eclipse** do the following:
1. Open the file _platform.target_ and click on _"Set as Active Target Platform"_
1. _de.slothsoft.mp4spliterator.product/Mp4SpliteratorApp.product_ and click on _"1. Synchronize"_ and then _"2. Launch Eclipse Application"_
1. To build the application with **Tycho**
- Run `mvn clean install` on the repository root
- Or in Eclipse right click on the _pom.xml_ and use _"Run as..."_ → _"Maven install"_
- The resulting EXE file is in _de.slothsoft.mp4spliterator.product/target/products/de.slothsoft.mp4spliterator.product-<time>-<os>.zip_ and / or the folder next to the ZIP file
1. when finished, call `mvn package -Pstop` to stop the P2 repository
**Note:** This project is a copy of the template [example-eclipse-application](https://github.com/slothsoft/example-eclipse-application). So if you need more information or if you like this setup, check it out!
*(More information can be found in the [developer guide](https://github.com/slothsoft/mp4-spliterator/wiki).)*
## Third Party Libraries
### Icons
Application icons are from [icons8](https://icons8.de/). The flags in the README are from [H. J. Nilsson](https://github.com/hjnilsson/country-flags).
### MP4
To get the meta data from MP4 files, [mp4parser](https://github.com/sannies/mp4parser) is used. Since this library doesn't support reading chapter files (yet), I tried implementing it with the help of the [official spec](https://www.adobe.com/content/dam/acom/en/devnet/flv/video_file_format_spec_v10.pdf) ("chpl" box, page 30).
Example files are from [here](http://techslides.com/sample-webm-ogg-and-mp4-video-files-for-html5).
## License
This project is licensed under the MIT License - see the [MIT license](LICENSE) for details.