Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ncronom/4fly
Real-time demuxer for MP4 containers and HLS protocol.
https://github.com/ncronom/4fly
Last synced: 25 days ago
JSON representation
Real-time demuxer for MP4 containers and HLS protocol.
- Host: GitHub
- URL: https://github.com/ncronom/4fly
- Owner: Ncronom
- Created: 2023-10-29T12:55:26.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-16T15:49:50.000Z (3 months ago)
- Last Synced: 2024-12-01T12:40:13.152Z (about 1 month ago)
- Language: Odin
- Homepage:
- Size: 74.8 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 4Fly
> [!warning]
> Keep in mind that 4Fly is still in the experimental phase and may not be bug-free or fully polished.
> Be aware of this when using it.
4Fly is a versatile cross-platform CLI tool that enables seamless demuxing and encoding of MP4 files, allowing for flexible fragmentation into segments of any duration. Its primary goal is to circumvent the limitations of traditional pre-fragmentation methods used in HLS protocols.
## Usages
### Fragmentation
```shell
$ 4Fly
path : mp4 video path
flags:
-time:[default = 3.0]
fragment duration.
-entity:[default=all - values:all;m3u8;init;]
Entity to generate.
```
*Exemple* :
```shell
# Creating HLS Manifest of 6.0 seconds long segments.
$ 4Fly .\test.mp4 -time:6.0 -entity:m3u8
# Creating FMP4 init file.
$ 4Fly .\test.mp4 -time:6.0 -entity:init
# Creating FMP4 20th fragment.
$ 4Fly .\test.mp4 -time:6.0 -entity:20
```
### Dump
You can display the file structure :
```shell
$ 4Fly dump
```
*Exemple*:
Run this :
```
$ 4Fly dump test.mp4
```
can output something like this :
```shell
[ftyp] 0
[moov] 0
| [mvhd] 1
| [trak] 1
| | [tkhd] 2
| | [edts] 2
| | | [elst] 3
| | [mdia] 2
| | | [mdhd] 3
| | | [hdlr] 3
| | | [minf] 3
| | | | [vmhd] 4
| | | | [dinf] 4
| | | | | [dref] 5
| | | | [stbl] 4
| | | | | [stsd] 5
| | | | | [stts] 5
| | | | | [stss] 5
| | | | | [ctts] 5
| | | | | [stsc] 5
| | | | | [stsz] 5
| | | | | [co64] 5
| [trak] 1
| | [tkhd] 2
| | [edts] 2
| | | [elst] 3
| | [mdia] 2
| | | [mdhd] 3
| | | [hdlr] 3
| | | [minf] 3
| | | | [smhd] 4
| | | | [dinf] 4
| | | | | [dref] 5
| | | | [stbl] 4
| | | | | [stsd] 5
| | | | | [stts] 5
| | | | | [stsc] 5
| | | | | [stsz] 5
| | | | | [co64] 5
| [udta] 1
| | [meta] 2
[mdat]
```
### HLS
To test with HLS protocole :
- Make shure you compile and have 4Fly binary in project root.
- Go to "server" folder
- Put your video in
- Rename the video to "test.mp4"
- Run :
```go
$ go run .
```
- Open your browser to [http://localhost:8080](http://localhost:8080)
... And that's it !
## Installation
### Compile from sources
From Windows, Linux or MacOS:
- Get odin compiler, you need the "core" library.
- Clone 4File main branch and build
```bash
git clone https://github.com/julienrull/4Fly.git
cd 4Fly
odin build .
```