Skip to content

shadowofaroman/Operation-Theep

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 

Repository files navigation

Theep

Theep is an open-source Android utility built with C#/.NET MAUI that provides essential system controls through a beautiful floating widget interface. Born from necessity, it's designed for devices with damaged hardware buttons or users seeking quick access to system functions.

Current Features

  • Beautiful Floating Widget - Modern glass-morphism UI with Material Design principles
  • Screenshot Capture - Software-based screenshot functionality
  • Volume Controls - Increase and decrease volume without physical buttons
  • Smart Toggle - Tap the phantom icon to show/hide the command pod
  • Drag & Drop - Position the widget anywhere on your screen
  • Ripple Effects - Smooth touch feedback for a premium feel

Demo

Screenshots/GIF coming soon

Architecture

Theep is built using:

  • .NET MAUI for cross-platform development
  • Android Foreground Services for persistent functionality
  • Window Overlay API for the floating widget
  • Action Broker Pattern for decoupled component communication

Getting Started

Prerequisites

  • Visual Studio 2022 or later
  • .NET 8.0 SDK
  • Android SDK (API 21+)

Installation

  1. Clone the repository git clone https://github.com/shadowofaroman/Operation-Theep.git
  2. Open Theep.sln in Visual Studio
  3. Set the Android project as the startup project
  4. Build and deploy to your Android device

Permissions Required

  • SYSTEM_ALERT_WINDOW - For floating widget overlay
  • FOREGROUND_SERVICE - For persistent service
  • FOREGROUND_SERVICE_SPECIAL_USE - For special use case declaration

Roadmap

  • Screen recording capability
  • Custom button remapping
  • Accessibility shortcuts
  • Gesture controls
  • Customizable themes
  • Widget positioning memory
  • Quick settings integration

Contributing

Theep is in active development and welcomes contributions. Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.

How to Contribute

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'feat: add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Coding Standards

  • Follow C# naming conventions
  • Keep methods focused and single-purpose
  • Add XML documentation for public APIs
  • Write meaningful commit messages (Conventional Commits style)

License

This project is licensed under the MIT License.

Acknowledgments

  • Built with the power of .NET MAUI
  • Inspired by the need for accessible system controls
  • Community-driven and open-source focused

Contact


Status: Alpha - Core functionality implemented, actively seeking community feedback and contributions.

Made with ❤️ and C#. Happy hacking

About

A utility mobile app built in .NET MAUI. Built for phones with broken hardware. Android only.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages