https://github.com/lucaArchidiacono/Scrolln

A mac OS menu bar app which handles the scrolling behaviour of a mouse and trackpad separately.
https://github.com/lucaArchidiacono/Scrolln

Last synced: 26 days ago
JSON representation

A mac OS menu bar app which handles the scrolling behaviour of a mouse and trackpad separately.

• Host: GitHub
• URL: https://github.com/lucaArchidiacono/Scrolln
• Owner: lucaArchidiacono
• License: mit
• Created: 2021-02-01T16:13:23.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2023-12-27T12:34:13.000Z (12 months ago)
• Last Synced: 2024-08-03T09:06:03.016Z (4 months ago)
• Language: Swift
• Size: 269 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• Mac-Menubar-Megalist - Scrolln

README

        
# Scrolln

Scrolln is a macOS application that provides a simple and intuitive way to control the natural scrolling direction for connected input devices. It allows you to customize the scrolling behavior for mice and trackpads connected to your Mac, making it easy to adapt to your preferences.

## Features

- **Device List**: View a list of connected input devices, including mice.

- **Natural Scrolling**: Toggle natural scrolling direction for each device individually.

- **Persistence**: Your customization preferences are persisted and applied automatically on each application launch.

## How to Use

1. **Device List**: Launch the application to view the list of connected devices.

2. **Natural Scrolling**: For each device listed, you can toggle the "Natural Scroll" switch to enable or disable natural scrolling based on your preference.

3. **Quit Application**: You can quit the application using the "Quit" button at the bottom of the device list. If you do so, the initial scrolling direction (before launching the App) will be reused again.

## Building and Running

### Requirements

- macOS 10.15 or later

### Build Instructions

1. Open the `Scrolln.xcodeproj` file in Xcode.

2. Build the project using the Xcode build and run commands.

### Running the Application

1. Build the project using Xcode.

2. Launch the built application.

## How It Works

Scrolln utilizes the IOKit framework to interact with connected input devices. It registers callbacks to be notified of device connection and disconnection events. The application stores user preferences using a simple JSON file, ensuring that your customization choices persist across launches.

## Contribution

Feel free to contribute to the project by submitting bug reports, feature requests, or pull requests. Your input is valuable!

## License

Scrolln is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.