KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

sss

★ 136 Open GitHub ↗

SSS (Super ScreenShot): CLI/Lib to take amazing screenshot of code or screen with selector ui and OCR built-in

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Super ScreenShot

Super ScreenShot is a set of libraries and tools for building screenshots in a standardized, high-performance image format made in rust.

[selector_ui_preview.webm](https://github.com/user-attachments/assets/7222278f-6738-4edd-b4c2-51330f90dfa1)

## 🧩 Workspace

The repo is a workspace of focused crates. Pick the layer you need — or compose them.

**Capture stack** (low-level, no third-party capture wrappers):

- [sss_capture](./crates/sss_capture): Cross-platform screen / monitor / window / region capture. Pure-Rust backends written from scratch on top of canonical OS bindings — Wayland (`wlr-screencopy` + portal fallback), X11 (`x11rb`, no `libxcb.so`), Win32 GDI `BitBlt`, macOS CoreGraphics.
- [sss_capture_ui](./crates/sss_capture_ui): Interactive **region / monitor / window picker** (`slurp`-class flow) **and** an **annotation editor** with brush, line, arrow, rectangle, ellipse, blur rectangle, eraser, numbered steps and text — every committed shape stays editable through the Pointer tool. Ships the `sss-select` binary, a drop-in `slurp` replacement.
- [sss_ocr](./crates/sss_ocr): OCR engine over [`oar-ocr`](https://crates.io/crates/oar-ocr) with tiered models, hardware-aware defaults (CPU / CUDA / TensorRT / CoreML / DirectML / OpenVINO / WebGPU) and a non-blocking model-download worker.

**Render stack** (composes the capture stack):

- [sss_lib](./crates/sss_lib): Base library for screenshot generation — shadows, gradient backgrounds, rounded corners, watermarks. Powers the other tools.
- [sss_code](./crates/sss_code): Terminal tool to render **source code → PNG** with syntax highlighting (themes from Sublime / VSCode).
- [sss](./crates/sss_cli): Main terminal tool — capture full screen / region / window, annotate, watermark, save or pipe.

## 🚀 Installation
> [!IMPORTANT]
> At the moment the tool is not available in any store. Please redirect to [releases](https://github.com/SergioRibera/sss/releases) section in order to download.

### ❄️ Nix

sss packages are built and cached automatically. To avoid unnecessary recompilations, you may use the binary cache.

```nix
nix.settings = {
  builders-use-substitutes = true;
  extra-substituters = [ "https://sss.cachix.org" ];
  extra-trusted-public-keys = [ "sss.cachix.org-1:YI2JMG95LEu62PC7VMz75N7bypEdUz9Z/Il1hkGH4AA=" ];
};
```

> [!WARNING]
> While using the sss flake, overriding the nixpkgs input for sss will cause cache hits, i.e., you will have to build from source every time. To use the cache, do not override the Nixpkgs input.

On nix you can use the provided flake:

```nix
# flake.nix
{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    sss = {
      url = "github:SergioRibera/sss";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

outputs = { self, nixpkgs }: {
    nixosConfigurations."<your_hostname>" = nixpkgs.lib.nixosSystem {
      # ...
      modules = [
        # Add sss to modules to make it available
        inputs.sss.nixosModules.default

{
          programs.sss {
            enable = true; # Enable principal cli to take screenshots
            code = true; # Enable sss_code to capture code
          }
        }
      ];
      # ...
    };
  };
}
```

### ❄️ Nix Home-Manager

> [!INFO]
> You can find more details about the available options at [here](./nix/hm-module.nix)

```nix
home-manager.users."yourusername" = ({
  imports = [
    inputs.sss.nixosModules.home-manager
  ];

programs.sss = {
    enable = true;
    code = {
      enable = true;
      line-numbers = true;
    };

general = {
      shadow = true;
      shadow-image = true;
      author = "@SergioRibera";
      colors = {
        background = "#FFFFFF";
        author = "#000000";
      };
    };
  };
};
```

## ⚙️ Configuration
> [!NOTE]
> To know how to configure it from a file, you can review the [default.toml](./examples/default_config.toml) file.
>
All cli arguments can be set from a single file in the path `~/.config/sss/config.toml`, right here you can place the configuration for `sss_code` and `sss`.

## 💻 Usage
You can find examples and options in the following links.
- [sss_cli](https://sergioribera.rustlang-es.org/sss/sss/): Screenshots of your screen.
- [sss_code](https://sergioribera.rustlang-es.org/sss/sss_code/): Screenshots of your code.

## 💡 Acknowledgments
- [syntect](https://github.com/trishume/syntect): Rust library for syntax highlighting using Sublime Text syntax definitions.
  - I use this library for code highlighting and parsing.
- [djanho](https://github.com/viniciusmuller/djanho): Convert VSCode themes to (Neo)Vim colorschemes
  - Use this project to understand how to import (Neo)vim themes.

## 🏁 Other Goals
- [silicon](https://github.com/Aloxaf/silicon): Create beautiful image of your source code.
  - I used it as a basis for my code screenshot project.

sss

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README