antonlyap/ffmpeg-android-cli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 4 Wiki Activity

Update README

Browse Source
This commit is contained in:
Anton Liaposhchenko 2024-06-16 07:55:46 +03:00
parent 50d2ed3b68
commit b05c1d7eb4
1 changed files with 39 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
README.md
View File

@ -11,7 +11,8 @@ Hardware acceleration with MediaCodec is enabled. Based on https://github.com/ar
## Installation ## Installation
1. Download your preferred version from https://gitea.antonlyap.pp.ua/antonlyap/ffmpeg-android-cli/releases 1. Download your preferred version
from https://gitea.antonlyap.pp.ua/antonlyap/ffmpeg-android-cli/releases
2. Extract the archive into a folder on your device (e.g. `/data/local/tmp`) 2. Extract the archive into a folder on your device (e.g. `/data/local/tmp`)
3. Make sure commands are executable: 3. Make sure commands are executable:
```shell ```shell
@ -35,6 +36,25 @@ Hardware acceleration with MediaCodec is enabled. Based on https://github.com/ar
``` ```
Passing arguments via environment variables (`FFMPEG_OPTIONS`) is also possible,
to work
around `app_process` [stack corruption due to command length](https://github.com/Genymobile/scrcpy/issues/2841):
```
$ FFMPEG_OPTIONS="-hwaccels" ./ffmpeg
ffmpeg version n7.0 Copyright (c) 2000-2024 the FFmpeg developers
built with Android (7155654, based on r399163b1) clang version 11.0.5 (https://android.googlesource.com/toolchain/llvm-project 87f1315dfbea7c137aa2e6d362dbb457e388158d)
configuration: --cross-prefix=aarch64-linux-android- --sysroot=/home/user/Android/Sdk/ndk/22.1.7171670/toolchains/llvm/prebuilt/linux-x86_64/sysroot --prefix=/home/user/Projects/ffmpeg-kit/prebuilt/android-arm64-lts/ffmpeg --pkg-config=/usr/bin/pkg-config --enable-version3 --arch=aarch64 --cpu=armv8-a --target-os=android --enable-neon --enable-asm --enable-inline-asm --ar=aarch64-linux-android-ar --cc=aarch64-linux-android21-clang --cxx=aarch64-linux-android21-clang++ --ranlib=aarch64-linux-android-ranlib --strip=aarch64-linux-android-strip --nm=aarch64-linux-android-nm --extra-libs='-L/home/user/Projects/ffmpeg-kit/prebuilt/android-arm64-lts/cpu-features/lib -lndk_compat' --disable-autodetect --enable-cross-compile --enable-pic --enable-jni --enable-optimizations --enable-swscale --disable-static --enable-shared --enable-pthreads --enable-v4l2-m2m --disable-outdev=fbdev --disable-indev=fbdev --enable-small --disable-xmm-clobber-test --disable-debug --enable-lto --disable-neon-clobber-test --disable-programs --disable-postproc --disable-doc --disable-htmlpages --disable-manpages --disable-podpages --disable-txtpages --disable-sndio --disable-schannel --disable-securetransport --disable-xlib --disable-cuda --disable-cuvid --disable-nvenc --disable-vaapi --disable-vdpau --disable-videotoolbox --disable-audiotoolbox --disable-appkit --disable-alsa --disable-cuda --disable-cuvid --disable-nvenc --disable-vaapi --disable-vdpau --disable-sdl2 --disable-openssl --disable-zlib --enable-mediacodec
libavutil 59. 8.100 / 59. 8.100
libavcodec 61. 3.100 / 61. 3.100
libavformat 61. 1.100 / 61. 1.100
libavdevice 61. 1.100 / 61. 1.100
libavfilter 10. 1.100 / 10. 1.100
libswscale 8. 1.100 / 8. 1.100
libswresample 5. 1.100 / 5. 1.100
Hardware acceleration methods:
mediacodec
```
## Building ## Building
1. Get your preferred version of FFmpeg from https://github.com/arthenica/ffmpeg-kit/releases 1. Get your preferred version of FFmpeg from https://github.com/arthenica/ffmpeg-kit/releases
@ -57,23 +77,36 @@ Hardware acceleration with MediaCodec is enabled. Based on https://github.com/ar
ffprobe ffprobe
``` ```
## Versioning
The project versions follow the `a.b-c-d` pattern, where:
- `a.b` is the FFmpeg version (major and minor), such as `7.0`
- `c` is the version of FFmpeg Kit
- `d` is the version of FFmpeg Android CLI
## Useful software and resources ## Useful software and resources
- [MediaCodecInfo](https://github.com/Parseus/codecinfo/releases) - displays the capabilities of - [MediaCodecInfo](https://github.com/Parseus/codecinfo/releases) - displays the capabilities of
your device. your device.
- [Qualcomm Hexagon (Wikipedia)](https://en.wikipedia.org/wiki/Qualcomm_Hexagon) - hardware
transcoding capabilities of different Qualcomm SoCs.
- [rclone](https://rclone.org) - lets you mount a remote filesystem (e.g. to transcode files from - [rclone](https://rclone.org) - lets you mount a remote filesystem (e.g. to transcode files from
your computer). your computer).
Requires root access and the `fusermount3` binary. Some media containers Requires root access and the `fusermount3` binary. Some media containers
require `--vfs-cache-mode=writes` to function properly. require `--vfs-cache-mode=writes` to function properly.
- [FFmpeg Streaming](https://trac.ffmpeg.org/wiki/StreamingGuide) - also lets you access remote - [FFmpeg Streaming](https://trac.ffmpeg.org/wiki/StreamingGuide)
and [FFmpeg protocols](https://ffmpeg.org/ffmpeg-protocols.html) - also let you access remote
files. files.
- [rffmpeg](https://github.com/joshuaboniface/rffmpeg) - lets you control transcoding from another - [rffmpeg](https://github.com/joshuaboniface/rffmpeg) - lets you control transcoding from another
machine over SSH. machine over SSH.
## License ## License
This project's code and build artifacts (APK file and its derivatives) are licensed under the GNU LGPL. This project's code and build artifacts (APK file and its derivatives) are licensed under the GNU
However, if using a variant of FFmpeg which includes GPL-licensed components, the build artifacts become LGPL.
However, if using a variant of FFmpeg which includes GPL-licensed components, the build artifacts
become
subject to the GPL. subject to the GPL.
More information: https://github.com/arthenica/ffmpeg-kit?tab=readme-ov-file#14-license More information: https://github.com/arthenica/ffmpeg-kit?tab=readme-ov-file#14-license