Skip to content

Saimonsanbr/easyscrollrec

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

easyscrollrec logo

easyscrollrec

Record smooth scroll videos of any webpage — one click, no setup

A companion tool to easybrawto

Release License Built with Tauri Powered by easybrawto


⬇ Download for macOS (Apple Silicon)    ⬇ Download for macOS (Intel)    ⬇ Download for Linux


What is this?

easyscrollrec is a small desktop app that records smooth scroll videos of any webpage.

Paste a URL, click Record, get an .mp4.

No browser extensions. No screen recording. No Python. Just a native app that captures the full page and animates it with ffmpeg.

Inspiration

This project was inspired by scrollrec by Victor Vasconcelos (viktorkav) — a great idea for recording scroll videos of webpages.

easyscrollrec takes a different approach: no Python, no Playwright, no headless browser abstractions. Instead it uses easybrawto (Crystal + CDP) to talk directly to the browser, and ffmpeg for video rendering — tools that feel more native to macOS and Linux, with no runtime dependencies to manage.


How it works

  1. Opens a temporary browser profile via easybrawto (bundled — no install needed)
  2. Navigates to the URL, triggers lazy loading, removes fixed elements
  3. Captures a full-page screenshot (up to 15,000px tall)
  4. Uses ffmpeg to animate a smooth crop — the video scrolls from top to bottom
  5. Saves the .mp4 wherever you want

The trick: it's not a screencast. It's a giant image + an animated crop. Clean, lightweight, no dropped frames.


Requirements

macOS / Linux:

brew install ffmpeg

That's it. ffmpeg is the only dependency. The easybrawto binary is bundled inside the app.


Installation

macOS

  1. Download the .dmg for your chip (Apple Silicon or Intel)
  2. Open the .dmg and drag the app to /Applications
  3. Remove quarantine (required for unsigned apps):
xattr -dr com.apple.quarantine /Applications/easyscrollrec.app
  1. Install ffmpeg if you haven't:
brew install ffmpeg
  1. Open the app and paste a URL.

Linux

  1. Download the .AppImage
  2. Make it executable:
chmod +x easyscrollrec_amd64.AppImage
./easyscrollrec_amd64.AppImage
  1. Install ffmpeg:
sudo apt install ffmpeg      # Debian/Ubuntu
sudo pacman -S ffmpeg        # Arch
sudo dnf install ffmpeg      # Fedora

Options

Option Values Default
Speed Slow / Normal / Fast / Very fast Normal
Quality 30 fps / 60 fps 60 fps
Output filename Any .mp4 name scroll_HH_MM_SS.mp4

Building from source

Requires Rust, Tauri CLI, and Node.js.

git clone https://github.com/Saimonsanbr/easyscrollrec
cd easyscrollrec
npm install
tauri dev

To build a release binary:

tauri build

The easybrawto binaries in src-tauri/binaries/ must be present before building. Download them from the easybrawto releases.


Powered by

  • easybrawto — CDP browser automation (bundled)
  • ffmpeg — video rendering
  • Tauri — native desktop app framework

License

MIT

About

Record smooth scroll videos of any webpage

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors