https://github.com/redraw/scroll

scroll stdout!
https://github.com/redraw/scroll

cli shell

Last synced: 4 days ago
JSON representation

scroll stdout!

• Host: GitHub
• URL: https://github.com/redraw/scroll
• Owner: redraw
• Created: 2022-07-25T19:16:37.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2022-08-03T12:33:02.000Z (almost 3 years ago)
• Last Synced: 2025-06-16T14:25:02.704Z (29 days ago)
• Topics: cli, shell
• Language: Python
• Homepage:
• Size: 192 KB
• Stars: 10
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# scroll

![demo](./demo.gif)

## Install

```

pip install scroll-term

```

## Examples

```bash

# scroll system logs output stream

journalctl -f | scroll

# scroll MIDI messages

aseqdump | scroll

# scroll text, with a 1 sec delay

scroll -d 1 file.txt

# scroll full height

some-command | scroll -l 0

```

## Usage

```

usage: scroll [-h] [-d DELAY] [-l LINES] [file]

Scroll stdout!

positional arguments:

  file                  file, defaults to stdin

optional arguments:

  -h, --help            show this help message and exit

  -d DELAY, --delay DELAY

                        delay in seconds between lines (default 0)

  -l LINES, --lines LINES

                        max lines, set to 0 for full screen (default 10)

```

## Use it as a library

```python

from scroll_term.cli import scroll

with open("path/to/file", "r") as f:

    scroll(f, delay=0.2)

```