h1. Screenshots

On Android, it is usually possible to take a screenshot by pressing simultaneously the @Volume Down@ and @Power@ buttons. A shortcut can also be added to the menu that pops up when long-pressing the @Power@ button. Unfortunately this doesn't work out-of-the-box in Replicant because [[GraphicsResearch#Android-software-renderer|libagl]], the software renderer used for SurfaceFlinger (screen compositor), has an incomplete OpenGL ES implementation.

h2. Taking screenshots in Replicant

It is possible to take screenshots from within Replicant by forcing SurfaceFlinger to use [[GraphicsResearch#Mesas-llvmpipe|llvmpipe]]. Be aware that this will make your system extremely slow and bring in [[Graphics#Known-issues-with-llvmpipe|rendering issues to apps such as Gallery and Orbot]].

h3. Replicant 6.0 0003

On Replicant 6.0 0003 it is only possible to change the software renderer system-wide. Please follow the instructions at [[Graphics#Choosing-the-default-software-renderer-on-Replicant-60-0003|Graphics - Choosing the default software renderer on Replicant 6.0 0003]].

h3. Replicant 6.0 0004

As of Replicant 6.0 0004, llvmpipe is used as the default renderer. However, due to performance reasons, an exception is in place that forces SurfaceFlinger to use libagl instead. Follow these steps to remove the exception:

# Install [[ADB]] on your computer. Make sure that it can access the device's [[ADB#Accessing-root-shell|root shell]] and that the [[ADB#Modifying-the-system-partition|system partition is mounted as writable]].
# Remove the file that makes SurfaceFlinger use libagl:
<pre>
adb shell rm /system/etc/libGLES_android/system/bin/surfaceflinger
</pre>
# Reboot your device.
# To revert, recreate the file (it is just an empty file):
<pre>
adb shell touch /system/etc/libGLES_android/system/bin/surfaceflinger
</pre>

h2. Taking screenshots with a computer

Regardless of which graphics renderer is enabled, it is possible to take screenshots when the device is connected to a computer through an USB cable. The following steps explain the procedure.

# Make sure [[ADB]] is installed on your computer and that it can access the device's [[ADB#Accessing-root-shell|root shell]].
# Download this script: "screencap.sh":https://git.replicant.us/replicant/vendor_replicant-scripts/plain/screencap/screencap.sh
# You need to have ffmpeg installed. If ffmpeg is not available on your GNU/Linux distribution but avconv is (e.g. as part of libav-tools), you will have to change the line
<pre>
FFMEG="ffmpeg"
</pre>
to
<pre>
FFMEG="avconv"
</pre>
at the beginning of the script.
# Run the script to take a screenshot:
<pre>
./screencap.sh -f OUTPUT.PNG
</pre>
@OUTPUT.PNG@ is the filename of the screenshot. The screenshot will be saved with this filename in the directory you are running the script in. The script only supports the PNG format for screenshots.

The display size in pixels is auto-detected. If you want the script to be faster, you can add the screen size as another option, e.g.:
<pre>
./screencap.sh -s 720x1280 -f OUTPUT.PNG
</pre>

h3. In recovery mode

It is also possible to take screenshots in recovery mode with the script by running:
<pre>
./screencap.sh -r -s SCREENSIZE -f OUTPUT.PNG
</pre>
Screen size detection does not work in recovery mode. The screen size must be specified.