Dwellpy Wiki

Welcome to the Dwellpy documentation! This wiki contains setup guides, configuration help, and troubleshooting information for Dwellpy - the accessibility dwell clicker that lets you click by hovering your cursor.

Quick Start

New to Dwellpy? Follow your platform's setup guide:

Platform	Setup Guide	Notes
Windows	Windows Setup Guide	Requires administrator privileges
macOS	macOS Setup Guide	Will prompt for accessibility permissions
Linux	Linux Setup Guide	X11 required (Wayland coming soon)

Essential Guides

Configuration Guide

Learn how to adjust Dwellpy's settings for your specific needs:

• Movement sensitivity and timing
• Transparency and visual options
• Scroll widget settings
• Recommendations for different conditions (head trackers, tremors, etc.)

Troubleshooting Guide

Fix common problems:

• Installation issues
• Permission and access problems
• Clicking not working correctly
• Performance issues

What is Dwellpy?

Dwellpy is an accessibility tool that automatically performs mouse clicks when you hover your cursor over a target area for a brief period. It's designed for people who have difficulty with traditional mouse clicking due to:

• Motor disabilities
• Hand tremors or cerebral palsy
• Use of head trackers or eye tracking systems
• Repetitive strain injuries
• Other conditions affecting fine motor control

Made by a disabled person for the disabled community.

Key Features

• Multiple click types: Left, right, double-click, and drag operations
• Floating menu widget: Hamburger menu that follows your cursor for always-accessible controls
• Smart scroll widget: Floating helper for document navigation
• Configurable sensitivity: Adjust timing and movement thresholds
• Cross-platform: Works on Windows, macOS, and Linux
• Flexible interface: Choose between traditional toolbar or floating menu widget

Getting Help

Before You Ask

1. Check the Troubleshooting Guide for common solutions
2. Try adjusting settings in the Configuration Guide
3. Make sure you followed your platform's setup guide completely

Where to Get Help

• Bug Reports: GitHub Issues
• Questions: GitHub Discussions
• Documentation Issues: Create an issue or pull request to improve these guides

Reporting Issues

When asking for help, please include:

• Your operating system and version
• What you expected to happen vs. what actually happened
• Steps to reproduce the problem
• Any error messages you see

Contributing

Found an error in the documentation? Want to improve a guide?

• Documentation improvements: Submit a pull request or create an issue
• Code contributions: See CONTRIBUTING.md
• Feedback: Let us know what's confusing or missing via GitHub issues

Quick Reference

Common Tasks

Task	Guide Section
Install Dwellpy	Platform Setup Guides
Adjust sensitivity	Configuration Guide → Core Settings
Set up auto-start	Your platform's setup guide
Fix clicking issues	Troubleshooting → Clicking Problems
Enable scroll widget	Configuration Guide → Scroll Widget

Default Settings

• Move Limit: 5 pixels
• Dwell Time: 1.0 seconds
• Transparency: Disabled

---

Dwellpy was created by and for the disability community. If these guides help you, consider sharing them with others who might benefit from accessible mouse control.