CapScroll is a screenshot tool for Linux that makes it easy to capture screen regions and create long screenshots from browsers, terminals, documents, and other scrollable content.
CapScroll supports X11 and Wayland, multi-monitor setups, and a wide range of Linux desktop environments.
Version 1.3.0 introduces a completely refactored Wayland capture pipeline, replacing desktop-specific screenshot utilities with native C# integration through standard XDG Desktop Portals.
Note
CapScroll v1.3.0 uses XDG Desktop Portals for Wayland screenshot capture and supported automated input. The required portal services and capabilities depend on your desktop environment.
Important
Upgrading from v1.2.1 or earlier? Previous releases used different screenshot and input mechanisms, including desktop-specific screenshot utilities, grim, and ydotool. Those legacy dependencies are no longer required by the new portal-based screenshot pipeline in v1.3.0. Automated input may still use ydotool as a fallback.
CapScroll supports both regular screenshots and scrolling screenshots.
For scrolling captures, CapScroll:
- Spans the virtual desktop across connected monitors.
- Captures the selected region.
- Automatically scrolls the content when the active display backend supports the required input operations.
- Captures subsequent frames.
- Detects when the end of the content is reached.
- Detects overlap between frames.
- Aligns and stitches the frames into a single image.
The goal is to make long screenshots as simple as selecting an area and letting CapScroll handle the rest.
Note
Watch CapScroll in action with a scrolling screenshot demonstration.
|
|
|
- Region capture
- Multi-monitor support
- Scrolling screenshot capture
- Automatic scrolling on X11
- Wayland screenshot capture through XDG Desktop Portals
- Automated Wayland scrolling when the required portal input capabilities are available
ydotoolfallback for supported input configurations- Automatic bottom-of-content detection
- Automatic frame alignment and stitching
- Dynamic overlap detection
- Capture cancellation
- Stitching progress reporting
- Capture preview
- Open captured image
- Open capture folder
- PNG output
.deb,.AppImage,.rpm, and portable.tar.gzpackaging- X11 and Wayland support
CapScroll can be useful for capturing:
- Web pages
- PDF documents
- Terminal output
- Long application views
- Documents
- Chat conversations
- Any other scrollable content
Note
Results may vary depending on how the target application renders content and handles scrolling.
CapScroll is designed for Linux desktop environments using X11 or Wayland. It uses native X11 integration on X11 sessions and XDG Desktop Portals for Wayland screenshot capture.
The portal-based approach is intended to work across desktop environments that provide compatible portal implementations, rather than being limited to a specific distribution or desktop.
| Desktop Environment | X11 | Wayland | Multi-Monitor |
|---|---|---|---|
| GNOME | Supported | Supported | Supported |
| KDE Plasma | Supported | Supported | Supported |
| COSMIC (Pop!_OS) | — | Supported | Supported |
| XFCE | Supported | Depends on available portal and session capabilities | Supported |
Wayland compatibility: Actual screenshot and input capabilities depend on the desktop environment, compositor, installed portal backend, and granted permissions. Other Linux desktop environments may work when they provide the required interfaces.
- Linux
- .NET 10 for running framework-dependent builds or building from source
- An active desktop session and D-Bus session bus
Native X11 capture and input use the system's X11 libraries:
libX11libXtst
Prebuilt packages may handle application dependencies according to their packaging configuration. Development headers are needed when building native integrations from source.
Wayland screenshot capture requires:
xdg-desktop-portal- A compatible desktop-specific portal backend
- An active D-Bus session bus
Common portal backends include:
xdg-desktop-portal-gnomexdg-desktop-portal-kdexdg-desktop-portal-cosmic
The relevant services must be available and support the requested screenshot operation.
For automated scrolling, the active portal backend must additionally provide the necessary RemoteDesktop input functionality and permissions. The ydotool fallback may be used when applicable.
Tip
Install the portal backend appropriate for your desktop environment. You do not need to install every desktop's screenshot utility.
CapScroll v1.1.0–v1.2.1 used various desktop-specific screenshot utilities and input tools, depending on the environment:
gnome-screenshotspectaclecosmic-screenshotgrimydotoolandydotoold
The old screenshot utilities are no longer required by the v1.3.0 portal-based screenshot pipeline. ydotool remains a possible fallback for automated input.
If you are upgrading, you do not need to install these legacy screenshot utilities specifically for CapScroll v1.3.0. You can keep them if other applications use them.
CapScroll has been tested on the following Linux distributions:
- Kali Linux
- Zorin OS
- Ubuntu
- Fedora Workstation 44
- Pop!_OS (COSMIC)
Testing has covered these desktop environments and display sessions:
- GNOME on X11 and Wayland
- KDE Plasma on X11 and Wayland
- XFCE on X11 and Wayland
- COSMIC on Wayland
These are tested environments, not an exhaustive list of supported Linux distributions. CapScroll is intended to work on other Linux distributions and desktop environments when the required display-session, portal, and system-library capabilities are available.
Download the latest release from the GitHub Releases page.
For Debian-based distributions such as Debian, Ubuntu, Linux Mint, and Kali Linux, download the .deb package and install it with:
sudo apt install ./capscroll_<VERSION>_amd64.debReplace <VERSION> with the version in the downloaded filename.
Download the AppImage release, make it executable, and launch it:
chmod +x CapScroll-*.AppImage
./CapScroll-*.AppImagePortal services and any required system libraries must still be available on the host system.
For Fedora and other RPM-based distributions, install the downloaded RPM package:
sudo dnf install ./capscroll-<VERSION>.rpmAdjust the filename to match the release artifact.
- Git
- .NET 10 SDK
- Native development libraries required by your build environment
git clone https://github.com/netcrawlerr/CapScroll.git
cd CapScrollRun the provided build script:
chmod +x ./scripts/build.sh
./scripts/build.shThe script automates the project's build and packaging process. Refer to the script for the available options and generated artifact locations.
- Start CapScroll.
- Select Capture Region.
- Select the area to capture.
- CapScroll captures the selected region.
- The image is saved automatically.
- Select Scrolling Capture.
- Select the scrollable area.
- CapScroll captures the initial view.
- CapScroll automatically scrolls the content.
- Additional frames are captured.
- CapScroll detects when the bottom of the content is reached.
- The frames are aligned and stitched together.
- The completed long screenshot is displayed.
- Ensure the appropriate XDG Desktop Portal services are available.
- Select Scrolling Capture.
- Select the scrollable area.
- Approve any portal permission prompts if they appear.
- CapScroll captures the initial view.
- CapScroll uses the portal-based input path when supported, with a
ydotoolfallback where applicable. - If automated input is unavailable, manually scroll the selected content when the workflow permits it.
- CapScroll captures subsequent frames.
- CapScroll detects when the content stops changing.
- The frames are automatically aligned and stitched together.
Tip
Automated scrolling on Wayland depends on the capabilities and permissions provided by the active portal backend. Manual scrolling may be necessary when automated input is unavailable.
Use the application's cancellation control. Where supported, you can also press:
Ctrl + Shift + Esc
Moving the mouse pointer outside the selected capture area can stop scrolling capture in workflows that use pointer position as part of the capture process.
Note
Available cancellation behavior depends on the active capture workflow.
Captured images are saved as PNG files.
By default, captures are stored in:
~/Pictures/CapScroll/
Example filename:
capture-YYYYMMDD-HHmmss.png
- CapScroll currently targets Linux; Windows and macOS are not supported.
- Wayland functionality depends on the active portal backend and compositor capabilities.
- Dynamic content may produce imperfect stitching.
CapScroll is licensed under the MIT License.



