Update README

README.md

@@ -11,7 +11,8 @@ Hardware acceleration with MediaCodec is enabled. Based on https://github.com/ar
 
 ## 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`)
 3. Make sure commands are executable:
     ```shell
@@ -35,11 +36,30 @@ 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
 
 1. Get your preferred version of FFmpeg from https://github.com/arthenica/ffmpeg-kit/releases
-    or https://gitea.antonlyap.pp.ua/antonlyap/ffmpeg-kit/releases (includes updated FFmpeg and
+   or https://gitea.antonlyap.pp.ua/antonlyap/ffmpeg-kit/releases (includes updated FFmpeg and
-    resolution alignment patch).
+   resolution alignment patch).
 2. Place the AAR file under `app/libs`
 3. Build the APK:
     ```shell
@@ -57,23 +77,36 @@ Hardware acceleration with MediaCodec is enabled. Based on https://github.com/ar
     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
 
 - [MediaCodecInfo](https://github.com/Parseus/codecinfo/releases) - displays the capabilities of
   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
   your computer).
   Requires root access and the `fusermount3` binary. Some media containers
   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.
 - [rffmpeg](https://github.com/joshuaboniface/rffmpeg) - lets you control transcoding from another
   machine over SSH.
 
 ## 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.
 
 More information: https://github.com/arthenica/ffmpeg-kit?tab=readme-ov-file#14-license

app/src/main/java/ua/pp/antonlyap/ffmpeg/CLI.kt

@@ -12,13 +12,16 @@ class CLI {
     companion object {
         @JvmStatic
         fun main(args: Array<String>) {
+            val envOptions = System.getenv("FFMPEG_OPTIONS")?.split(" ")?.toTypedArray()
+            val argOptions = args.drop(1).toTypedArray()
+            val options = envOptions ?: argOptions
             if (args[0].endsWith("ffmpeg")) {
                 FFmpegKitConfig.enableLogCallback { handleLog(it) }
-                val session = FFmpegKit.executeWithArguments(args.drop(1).toTypedArray())
+                val session = FFmpegKit.executeWithArguments(options)
                 Thread.sleep(200)
                 exitProcess(session.returnCode.value)
             } else if (args[0].endsWith("ffprobe")) {
-                val session = FFprobeKit.executeWithArguments(args.drop(1).toTypedArray())
+                val session = FFprobeKit.executeWithArguments(options)
                 print(session.output)
                 exitProcess(session.returnCode.value)
             } else {

cmd/ffmpeg

@@ -1,11 +1,15 @@
 #!/system/bin/sh
 
 BASE_DIR=$(dirname $0)
+ABIS=$(getprop ro.system.product.cpu.abilist)
+ABIS=${ABIS:-$(getprop ro.product.cpu.abilist)}
 
-for LIB_DIR in $BASE_DIR/lib/{$(getprop ro.system.product.cpu.abilist)}; do
+for LIB_DIR in $BASE_DIR/lib/{$ABIS}; do
     [ -d "$LIB_DIR" ] && break
     unset -v LIB_DIR
 done
 
-LD_LIBRARY_PATH=$LIB_DIR:/system/lib64:/system/lib:/etc/lib \
+app_process \
-app_process -Djava.class.path=$BASE_DIR/classes.dex /sdcard ua.pp.antonlyap.ffmpeg.CLI ffmpeg "$@"
+  -Djava.class.path=$BASE_DIR/classes.dex \
+  -Djava.library.path=$LIB_DIR:/system/lib64:/system/lib \
+  /sdcard ua.pp.antonlyap.ffmpeg.CLI ffmpeg "$@"

cmd/ffprobe

@@ -1,11 +1,15 @@
 #!/system/bin/sh
 
 BASE_DIR=$(dirname $0)
+ABIS=$(getprop ro.system.product.cpu.abilist)
+ABIS=${ABIS:-$(getprop ro.product.cpu.abilist)}
 
-for LIB_DIR in $BASE_DIR/lib/{$(getprop ro.system.product.cpu.abilist)}; do
+for LIB_DIR in $BASE_DIR/lib/{$ABIS}; do
     [ -d "$LIB_DIR" ] && break
     unset -v LIB_DIR
 done
 
-LD_LIBRARY_PATH=$LIB_DIR:/system/lib64:/system/lib:/etc/lib \
+app_process \
-app_process -Djava.class.path=$BASE_DIR/classes.dex /sdcard ua.pp.antonlyap.ffmpeg.CLI ffprobe "$@"
+  -Djava.class.path=$BASE_DIR/classes.dex \
+  -Djava.library.path=$LIB_DIR:/system/lib64:/system/lib \
+  /sdcard ua.pp.antonlyap.ffmpeg.CLI ffmpeg "$@"