scroller

A simple application that scrolls through a folder's images.

Table of Contents

• Features
• Prerequisites
• Installation
• Usage
• Development
• Testing
• Support
• Contribution
• License

Features

• Scroll through images in a folder
• Control scroll speed with scroll wheel
• Add/Remove columns to scroll view
• Save hovered image to ~/pictures/saved via middle-click

Prerequisites

• Python >=3.9, <3.12
• Make
• Poetry

Installation

pip install scroller

Alternatively, navigate to the GitHub releases page.

Usage

scroller

Development

git clone https://github.com/robert-clayton/scroller.git
cd scroller
make install
make run

Testing

make test

Support

Please open an issue for support.

Contribution

We appreciate any contribution, from fixing a grammar mistake in a comment to implementing complex algorithms. Please read this section if you are contributing your work.

Your contribution will be tested by our automated testing on GitHub Actions to save time and mental energy. After you have submitted your pull request, you should see the GitHub Actions tests start to run at the bottom of your submission page. If those tests fail, then click on the details button try to read through the GitHub Actions output to understand the failure. If you do not understand, please leave a comment on your submission page and a community member will try to help.

Please help us keep our issue list small by adding fixes: #{$ISSUE_NO} to the commit message of pull requests that resolve open issues. GitHub will use this tag to auto-close the issue when the PR is merged.

Keybinds

• Ctrl-O - set folder to view
• Scrollwheel - increase/decrease scroll speed
• Ctrl-Scrollwheel - add/remove column to scroll view
• Middle Mouse Button - saves the hovered image to ~/pictures/saved (on windows)

License

This project is licensed under the LGPLv2.1 License.