Dwellpy

Click by hovering instead of pressing mouse buttons. Dwellpy automatically performs clicks when you position your cursor over a target and wait briefly.

Built for users with motor disabilities who use head trackers, eye-tracking systems, or have difficulty with traditional mouse clicking due to conditions like cerebral palsy, hand tremors, or muscular dystrophy.

Made by a disabled person for the disabled community.

Quick Start

For End Users

Linux (Automated Install):

curl -sSL https://raw.githubusercontent.com/code0nwheels/dwellpy/main/linux-install.sh | bash

To uninstall:

curl -sSL https://raw.githubusercontent.com/code0nwheels/dwellpy/main/linux-uninstall.sh | bash

All Platforms (pip):

pip install dwellpy
dwellpy

Standalone executables coming soon for easier installation.

Need help? Check the setup guides for your operating system.

For Developers

git clone https://github.com/code0nwheels/dwellpy.git
cd dwellpy
pip install -r requirements.txt
python -m dwellpy.main

What it does

• Multiple click types: Left, right, double-click, and drag operations
• Smart scrolling: Floating widget for hands-free document navigation
• Visual feedback: Customizable click animations with distinctive colors for each action type
• Organized settings: Tabbed interface with logical grouping (Dwell, Visual, Scroll, General)
• Dwell-friendly controls: Large buttons with hover functionality for easy adjustment
• Auto-collapse UI: Minimize screen clutter with intelligent toolbar behavior
• Configurable: Adjust sensitivity for different motor abilities and use cases
• Cross-platform: Windows, macOS, and Linux support

Documentation

Detailed guides are available in the project wiki:

• Windows Setup Guide
• macOS Setup Guide
• Linux Setup Guide
• Configuration Guide
• Troubleshooting

Contributing

This project was created by and for the disability community. We welcome:

• Bug reports: Use GitHub Issues
• Feature requests: Especially accessibility improvements
• Documentation: Help improve setup guides
• Code contributions: See CONTRIBUTING.md

Development Setup

1. Fork the repository
2. Create a virtual environment: python -m venv venv
3. Activate it: source venv/bin/activate (Linux/Mac) or venv\Scripts\activate (Windows)
4. Install dependencies: pip install -r requirements.txt
5. Run tests: python -m pytest (when available)
6. Make your changes and submit a pull request

Project Structure

dwellpy/
├── dwellpy/              # Main application package
│   ├── core/            # Dwell detection and input handling
│   ├── ui/              # User interface components  
│   ├── managers/        # Application state management
│   └── config/          # Configuration and settings
├── docs/                # Documentation
└── tests/               # Test suite (coming soon)

License

GNU General Public License v3.0. See LICENSE for details.

Questions? Check the wiki or open an issue.