#!/usr/bin/env python3 import os import socket import struct import subprocess import sys from PIL import Image def capture_emu_screenrecord(serial, out_path): adb_cmd = ["adb"] if serial: adb_cmd += ["-s", serial] abs_out = os.path.abspath(out_path) os.makedirs(os.path.dirname(abs_out), exist_ok=True) tmp_out = abs_out + ".tmp.png" if os.path.exists(tmp_out): os.remove(tmp_out) res = subprocess.run(adb_cmd + ["emu", "screenrecord", "screenshot", tmp_out], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True) if os.path.isfile(tmp_out) and os.path.getsize(tmp_out) > 2000: try: im = Image.open(tmp_out) colors = im.getcolors(maxcolors=100000) num_colors = len(colors) if colors else 100000 if num_colors > 10: os.replace(tmp_out, abs_out) return True except Exception: pass if os.path.exists(tmp_out): os.remove(tmp_out) return False def capture_screencap(serial, out_path): # Try screencap to /data/local/tmp/ tmp_path = "/data/local/tmp/screen_cap.png" adb_cmd = ["adb"] if serial: adb_cmd += ["-s", serial] res = subprocess.run(adb_cmd + ["shell", f"screencap -p {tmp_path}"], stdout=subprocess.PIPE, stderr=subprocess.PIPE) if res.returncode == 0: pull_res = subprocess.run(adb_cmd + ["pull", tmp_path, out_path], stdout=subprocess.PIPE, stderr=subprocess.PIPE) subprocess.run(adb_cmd + ["shell", f"rm {tmp_path}"], stdout=subprocess.PIPE, stderr=subprocess.PIPE) if pull_res.returncode == 0 and os.path.isfile(out_path) and os.path.getsize(out_path) > 2000: try: im = Image.open(out_path) colors = im.getcolors(maxcolors=20) if colors and len(colors) <= 2: return False return True except Exception: return False return False def capture_framebuffer(serial, out_path): s = socket.socket(socket.AF_INET, socket.SOCK_STREAM) s.connect(('127.0.0.1', 5037)) if serial: transport_msg = f"host:transport:{serial}".encode() else: transport_msg = b"host:transport-any" req = f"{len(transport_msg):04x}".encode() + transport_msg s.sendall(req) resp = s.recv(4) if resp != b"OKAY": err_len = int(s.recv(4) or b"0", 16) err = s.recv(err_len).decode() s.close() raise RuntimeError(f"Transport error: {err}") fb_msg = b"framebuffer:" s.sendall(f"{len(fb_msg):04x}".encode() + fb_msg) resp = s.recv(4) if resp != b"OKAY": s.close() raise RuntimeError(f"Framebuffer service error: {resp}") # Header is 52 bytes (13 uint32) header = b"" while len(header) < 52: chunk = s.recv(52 - len(header)) if not chunk: break header += chunk if len(header) < 52: s.close() raise RuntimeError("Truncated framebuffer header") fields = struct.unpack('<13I', header) version = fields[0] bpp = fields[1] size = fields[2] width = fields[3] height = fields[4] red_offset, red_len = fields[5], fields[6] blue_offset, blue_len = fields[7], fields[8] green_offset, green_len = fields[9], fields[10] alpha_offset, alpha_len = fields[11], fields[12] # Read pixel data data = bytearray() while len(data) < size: chunk = s.recv(min(65536, size - len(data))) if not chunk: break data.extend(chunk) s.close() if len(data) < size: raise RuntimeError(f"Truncated pixel data: got {len(data)}, expected {size}") if bpp == 32: # Standard 32-bit RGBA or BGRA if red_offset == 0: mode = "RGBA" else: mode = "BGRA" im = Image.frombuffer("RGBA", (width, height), bytes(data), "raw", mode, 0, 1) elif bpp == 16: # RGB 565 im = Image.frombuffer("RGB", (width, height), bytes(data), "raw", "BGR;16", 0, 1) else: raise RuntimeError(f"Unsupported bpp: {bpp}") os.makedirs(os.path.dirname(os.path.abspath(out_path)), exist_ok=True) im.save(out_path, "PNG") return True def main(): if len(sys.argv) < 2: print("Usage: adb_screenshot.py [serial]") sys.exit(1) out_path = sys.argv[1] serial = sys.argv[2] if len(sys.argv) > 2 else None # Try emulator host screenshot first (works on all Android versions including 2.x) if capture_emu_screenrecord(serial, out_path): print(f"Captured screenshot via emu screenrecord: {out_path} ({os.path.getsize(out_path)} bytes)") return # Try screencap next (Android 4.0+) if capture_screencap(serial, out_path): print(f"Captured screenshot via screencap: {out_path} ({os.path.getsize(out_path)} bytes)") return # Fallback to framebuffer protocol if capture_framebuffer(serial, out_path): print(f"Captured screenshot via framebuffer: {out_path} ({os.path.getsize(out_path)} bytes)") return print("Failed to capture screenshot") sys.exit(1) if __name__ == "__main__": main()