PitchHut logo
peck
Easily capture screenshots and screen recordings on Wayland.
Pitch

Peck is a straightforward screen capture tool for Wayland, designed to simplify the process of taking screenshots and recording your screen. Utilizing existing tools like grim and wf-recorder, it allows for quick captures, customizable outputs, and easy conversions between formats. Simple to set up and use, peck enhances the screen recording experience on Wayland.

Description

peck is an efficient screen capture utility designed specifically for Wayland, offering users an intuitive way to capture screenshots and record their screens. This lightweight tool simplifies the use of grim and wf-recorder, presenting a straightforward interface for various screen capturing tasks.

Key Features

  • Screenshot and Recording Options: Capture screenshots or record your screen with precision, allowing users to select specific regions as needed.
  • User-Friendly Controls: Easily start and stop recordings with minimal effort, streamlining the capture process.
  • Flexible Saving Options: Outputs can be directed to default directories, temporary folders, or specified custom paths to suit individual preferences.
  • Clipboard Integration: Copy the resulting output directly to the clipboard for seamless sharing and pasting.
  • Versatile Format Support: Convert recordings to multiple formats such as mp4, gif, and webm using the powerful ffmpeg tool.
  • Notification Support: Optionally send notifications via libnotify to inform users about the status of their captures.

Usage Examples

To utilize peck effectively, it can be integrated into window managers or executed directly through the CLI. Here are several command examples:

Basic Screenshot Command

peck

Captures a screenshot, automatically saving it to the default screenshot directory.

Save Screenshot to a Custom Path

peck ./foo.png
peck bar/baz

Stores screenshots at user-defined locations.

Start Screen Recording

peck --record

Initiates screen recording; stop the process with CTRL-C or by executing peck again.

Convert Recording to GIF

peck --record --format=gif

Record the screen while converting the output to a GIF format.

Temporary Screenshot to Clipboard

peck --temp --clipboard

This command captures a screenshot, saves it temporarily in /tmp/, and copies it to the clipboard for immediate use.

Custom ffmpeg Filter for Video Recording

peck --record --format webm --filter "fps=30,scale=1280:-1:flags=lanczos"

Record and convert video using a specified ffmpeg filter for enhanced quality.

Command-line Options

FlagShortDescription
--clipboard-cCopies the output to the clipboard.
--record-rInitiates screen recording instead of taking a screenshot.
--temp-tSaves the file in a temporary directory that is cleared after each use.
--freeze-zFreezes the screen before taking a screenshot; cannot be used with recording.
--format <file_format>-fSpecifies the output format for screenshots and recordings.
--filter <video_filter>-FApplies a custom ffmpeg video filter during conversion.

Overall, peck serves as a straightforward, yet powerful tool for those utilizing Wayland, enhancing the screen capturing experience with its practical features and easy-to-use commands.

0 comments

No comments yet.

Sign in to be the first to comment.