A simple, scriptable workflow for recording, pulling, and compressing Android screen recordings using ADB.

• ✅ Record Android screen using adb shell screenrecord
• ✅ Manual stop via Ctrl+C without corrupting the output
• ✅ Automatically remembers your recording parameters
• ✅ Finalize: Pull and delete the recording from the device
• ✅ Compress recorded videos using ffmpeg

./record-adb.sh record [--size <num>] [--output <name>]

• --size: Target resolution (e.g. 300 becomes 300x300)
• --output: Base filename (default: screencast)

📌 Press Ctrl+C when you're done recording

📌 If resolution is omitted, it will be the detected screen size from the device

./record-adb.sh finalize

• Pulls the video from your device
• Deletes the remote file
• Uses the parameters saved from the record step

./record-adb.sh compress [--output <name>]

• Compresses <name>.mp4 into <name>_compressed.mp4
• If no name is provided, it uses the last recorded filename

# Record a 480x480 video named "demo"
./record-adb.sh record --size 480 --output demo

# After Ctrl+C, finalize it
./record-adb.sh finalize

# Compress it
./record-adb.sh compress

• adb (Android Debug Bridge)
• ffmpeg (for compression)

MIT

I am developing this package on my free time, so any support, whether code, issues, or just stars is very helpful to sustaining its life. If you are feeling incredibly generous and would like to donate just a small amount to help sustain this project, I would be very very thankful!

I welcome any issues or pull requests on GitHub. If you find a bug, or would like a new feature, don't hesitate to open an appropriate issue and I will do my best to reply promptly.