https://github.com/thogaruchesti-hemanth/rulerx
A floating, rotatable, and transparent ruler overlay for Android — measure, align, or aim over any app with drag, rotation, transparency control, and auto-hide.
https://github.com/thogaruchesti-hemanth/rulerx
aim-tool android clean-architecture drag-and-drop floating-overlay foreground-service java overlay rotate ruler screen-measurement system-alert-window transparency utility-app
Last synced: 2 months ago
JSON representation
A floating, rotatable, and transparent ruler overlay for Android — measure, align, or aim over any app with drag, rotation, transparency control, and auto-hide.
- Host: GitHub
- URL: https://github.com/thogaruchesti-hemanth/rulerx
- Owner: Thogaruchesti-hemanth
- License: mit
- Created: 2025-07-31T11:15:50.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-31T11:18:55.000Z (12 months ago)
- Last Synced: 2025-08-13T07:38:29.620Z (12 months ago)
- Topics: aim-tool, android, clean-architecture, drag-and-drop, floating-overlay, foreground-service, java, overlay, rotate, ruler, screen-measurement, system-alert-window, transparency, utility-app
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📏 Screen Ruler Overlay
A professional **floating screen ruler overlay** for Android, built in **Java** with a clean architecture.
Easily **measure**, **align**, or **aim** across any app — including games — using a **movable, rotatable, and transparent ruler** that stays on top of other apps.
---
## ✨ Features
✅ **Overlay on top of any app** – works while gaming, browsing, or designing
✅ **Draggable** – move freely anywhere on the screen
✅ **Rotatable** – adjust ruler angle for perfect alignment
✅ **Adjustable Transparency** – control visibility to your preference
✅ **Auto-Hide** – hide ruler after inactivity
✅ **Persistent Settings** – remembers position, rotation, and transparency
✅ **Lightweight & Optimized** – minimal performance impact
---
## 📸 Screenshots
| Overlay Ruler | Rotation | Transparency |
|---------------|----------|--------------|
|  |  |  |
---
## 🚀 Getting Started
### 1️⃣ Clone the Repository
```bash
git clone https://github.com/YOUR_USERNAME/ScreenRulerOverlay.git
cd ScreenRulerOverlay
````
### 2️⃣ Open in Android Studio
* Open **Android Studio**
* Select **Open an existing project**
* Choose the cloned folder
### 3️⃣ Build & Run
* Connect an Android device (or use an emulator)
* Click **Run ▶**
---
## 📱 Permissions
The app requires the **Draw Over Other Apps** permission to display the ruler:
```xml
```
On first launch, the app will guide you to enable it in **Settings**.
---
## 🛠️ Tech Stack
* **Language**: Java (Android)
* **Architecture**: Clean Architecture + MVVM
* **UI**: Custom View for scalable ruler
* **Persistence**: SharedPreferences for settings
* **Services**: Foreground Service for stable overlays
---
## 📂 Project Structure
```
com.example.ruleroverlay
│
├── data/ # Data storage & preferences
├── domain/ # Core business logic
├── ui/ # Activities, overlay service, custom views
├── utils/ # Permission & helper utilities
└── App.java # Application class
```
---
## ⚠️ Disclaimer
This tool is designed for **utility and measurement purposes**.
Using it in competitive games **may violate their terms of service**.
The author is **not responsible** for any misuse or consequences.
---
## 📄 License
This project is licensed under the **MIT License** – see the [LICENSE](LICENSE) file for details.
---
## 🤝 Contributing
Contributions are welcome!
1. Fork the repo
2. Create a feature branch (`git checkout -b feature-name`)
3. Commit your changes (`git commit -m "Add new feature"`)
4. Push to the branch (`git push origin feature-name`)
5. Open a Pull Request
---
## 🌟 Show Your Support
If you find this project helpful, **please give it a ⭐ on GitHub** to help others discover it!