KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #deepseek-harness #typescript #ai-agent #codex #developer-tools #claude-code #windows #mcp #python #desktop-app

Android-fast-screen-capture

★ 68 Open GitHub ↗

Android fast screen capture take a screenshot or compressed stream on any other Android device. Not needed root devices. ADB required.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Android fast screen capture - image or compressed image stream output

- Android fast screen capture take a screenshot or compressed stream on any other Android device.  
- Not needed root devices.   
- ADB required (default run permissions using).  
- For best perfomance using `OpenMP` for Android.
- Include all using system library, fake version (for [Android 5.1.1](https://github.com/ClnViewer/android-platform-headers/tree/master/android-5.1.1_r1) headers)
- Default build tools: [ndk-build](https://developer.android.com/ndk/downloads?hl=hi#beta-downloads), including Code::Blocks project using [C::B NDK project template](https://github.com/ClnViewer/Code-Blocks-Android-NDK), NDK build auto configuration support.

----

- [Features](#features)
- [Stream/Image compressed - header format using](#streamimage-compressed---header-format-using)
- [Installing pre-build binary](#installing-pre-build)
- [Using from command line](#using)
- [Example using SDL2 output format](#example-using-sdl2-output-format)

----

### Features

- image output format: **raw bitmap** `24 bpp`, include header.
- video stream output format: **raw compressed bitmap** `lz4 stream` - `24 bpp`, include header + packet header.
- video stream is 5 - 20 fps, depends on the CPU device.  
- pack image by ratio: valid values `1-9` (`lz4`).
- resize image by ratio: valid values `1-5`.
- rotate image: `90,180,270`
- mirror image.
- SDL2 [Texture](#example-using-sdl2-output-format) output compatible mode: Landscape screen.
- save image to location specified (bmp format).
- default save path: /data/local/tmp/AScreenCap.bmp

Run time statistic, milliseconds:

5 ms. - load and initialization
       40-151 ms. - capture screen - android::ScreenshotClient(), depends on the CPU device   
           40 ms. - image convert, resize and rotate
          196 ms. - maximal total time

### Stream/Image compressed - header format using

Packet stream include no pack header, size 160bit  `uint32[5]`, after image compressed body:
- octet `0` - unique identifier `BMZ1` (`0x315a4d42`/`828001602`).  
- octet `1` - size to uncompressed image.
- octet `2` - size to compressed image.
- octet `3` - image width.
- octet `4` - image height.

### Installing pre-build

Download binary for you device from [dist/](https://github.com/ClnViewer/Android-fast-screen-capture/blob/master/dist/) directory:

Building details:

#### Android 5.x - 7.x | [armeabi-v7a](https://github.com/ClnViewer/Android-fast-screen-capture/blob/master/dist/5/armeabi-v7a) | [arm64-v8a](https://github.com/ClnViewer/Android-fast-screen-capture/blob/master/dist/5/arm64-v8a) | [x86](https://github.com/ClnViewer/Android-fast-screen-capture/blob/master/dist/5/x86) | [x86_64](https://github.com/ClnViewer/Android-fast-screen-capture/blob/master/dist/5/x86_64)

> Application platform: `android-21`   
> Android system AOSP library version compatible: `5.1.1 - 7.x.x`   
> NDK build version: `r20-beta2`

#### Android 8.x | [armeabi-v7a](https://github.com/ClnViewer/Android-fast-screen-capture/blob/master/dist/8/armeabi-v7a) | [arm64-v8a](https://github.com/ClnViewer/Android-fast-screen-capture/blob/master/dist/8/arm64-v8a) | [x86](https://github.com/ClnViewer/Android-fast-screen-capture/blob/master/dist/8/x86) | [x86_64](https://github.com/ClnViewer/Android-fast-screen-capture/blob/master/dist/8/x86_64)

> Application platform: `android-27`   
> Android system AOSP library version compatible: `8.0.0 - 8.1.x`   
> NDK build version: `r20-beta2`

#### Android 9.x | [armeabi-v7a](https://github.com/ClnViewer/Android-fast-screen-capture/blob/master/dist/9/armeabi-v7a) | [arm64-v8a](https://github.com/ClnViewer/Android-fast-screen-capture/blob/master/dist/9/arm64-v8a) | [x86](https://github.com/ClnViewer/Android-fast-screen-capture/blob/master/dist/9/x86) | [x86_64](https://github.com/ClnViewer/Android-fast-screen-capture/blob/master/dist/9/x86_64)

> Application platform: `android-28`   
> Android system AOSP library version compatible: `9.0.0 - 9.1.x`   
> NDK build version: `r20-beta2`

Using ADB to send binary to device:

adb push dist/<my platform>/ascreencap /data/local/tmp/
      adb shell chmod 0777 /data/local/tmp/ascreencap

### Using

Command line options:

-f	--file		: output save to file, value is name
	-s	--stream	: output to loop stream (STDOUT)
		--stdout	: output to STDOUT
	-p	--pack		: output pack lz4 algorithm, valid value 1-9
		--sdl		: output SDL2 Texture compatible mode: Landscape screen
		--ratio 	: image resize ratio, valid scale 1-5
		--rotate	: image rotate: 90,180,270, value 360 = mirror
	-h	--help		: this help screen

Example run:

adb exec-out /data/local/tmp/ascreencap -f /data/local/tmp/my.bmp
       adb exec-out /data/local/tmp/ascreencap -f /data/local/tmp/my.bmz // << save lz4 compressed image
       adb exec-out /data/local/tmp/ascreencap --rotate 90 --ratio 2
       adb exec-out /data/local/tmp/ascreencap --rotate 360 // << mirror image :)
       adb exec-out /data/local/tmp/ascreencap --stream

### Example using SDL2 output format

Run:

```shell
adb exec-out /data/local/tmp/ascreencap --stream --sdl --ratio 2 | my-capture-prog.executable
```

Part of code `my-capture-prog.executable`

```C++
    /// check data header valid
    uint32_t *id = 'data from ascreencap';
    if (*id != 0x315a4d42)
        return;

/// begin SDL2 Create Texture
    uint32_t *width  = 'data from ascreencap' + (sizeof(uint32_t) * 3);
    uint32_t *height = 'data from ascreencap' + (sizeof(uint32_t) * 4);

SDL_Texture *texture = SDL_CreateTexture(
                renderer,
                SDL_PIXELFORMAT_RGB24,
                SDL_TEXTUREACCESS_STREAMING,
                *width,
                *height
            );

/// ...

/// get uncompressed size from header
    uint32_t *psize = 'data from ascreencap' + sizeof(uint32_t);
    /// offset data = first 160bit uint32[5] data header from ascreencap
    uint32_t offset = sizeof(uint32_t) * 5;
    /// uncompress data from ascreencap, using lz4
    uint8_t *uncompressdata = ...lz4('data from ascreencap' + offset)
    
    void *pix = nullptr;
    int32_t pitch = 0;
    
    SDL_LockTexture(texture, nullptr, &pix, &pitch);
    if ((!pix) || (!pitch))
        return;
	
    ::memcpy(pix, uncompressdata, *psize);

SDL_UnlockTexture(texture);

```

See full [ADB capture source](https://github.com/ClnViewer/ADB-Android-Viewer/blob/f61a59666fd888ba99c79537f0b4ae4c696eec13/src/ADBDriverDLL/src/DriverSocket/DriverSocketCapture.cpp#L7)

Android-fast-screen-capture

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README