# aShellYou

**Repository Path**: baihonghua/aShellYou

## Basic Information

- **Project Name**: aShellYou
- **Description**: A material you designed app for your ADB needs
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-12
- **Last Updated**: 2026-02-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="https://capsule-render.vercel.app/api?type=waving&height=300&color=gradient&text=aShell%20You&animation=fadeIn&desc=ADB%20at%20your%20fingertips&descAlign=50&descAlignY=55&fontAlignY=35" />
</p>

> **aShell You** is a fully-featured Android shell utility app with **Material Design 3 UI**, letting you run **ADB**, **root** and **shell** commands on your  device or others via OTG/wireless, packed in a beautiful and smart interface

</br>

<p align="center"> 
<a href="https://github.com/DP-Hridayan/aShellYou/stargazers">
    <img alt="GitHub stars" src="https://img.shields.io/github/stars/DP-Hridayan/aShellYou?style=for-the-badge&logo=github&label=Stars" />
  </a>
  <a href="https://github.com/DP-Hridayan/aShellYou/forks">
    <img alt="GitHub forks" src="https://img.shields.io/github/forks/DP-Hridayan/aShellYou?style=for-the-badge&logo=github&label=Forks" />
  </a>
  <a href="https://github.com/DP-Hridayan/aShellYou/issues">
    <img alt="GitHub issues" src="https://img.shields.io/github/issues/DP-Hridayan/aShellYou?style=for-the-badge&logo=github&label=Issues" />
  </a>
  <a href="https://github.com/DP-Hridayan/aShellYou/releases">
    <img alt="GitHub release" src="https://img.shields.io/github/v/release/DP-Hridayan/aShellYou?style=for-the-badge&logo=github&label=Release" />
  </a>
  <a href="https://github.com/DP-Hridayan/aShellYou/releases">
    <img alt="GitHub All Releases" src="https://img.shields.io/github/downloads/DP-Hridayan/aShellYou/total?style=for-the-badge&logo=download&label=Downloads" />
  </a>
  <a href="https://github.com/DP-Hridayan/aShellYou/graphs/contributors">
    <img alt="Contributors" src="https://img.shields.io/github/contributors/DP-Hridayan/aShellYou?style=for-the-badge&logo=github&label=Contributors" />
  </a>
  <a href="https://github.com/DP-Hridayan/aShellYou/blob/main/LICENSE">
    <img alt="License" src="https://img.shields.io/github/license/DP-Hridayan/aShellYou?style=for-the-badge&logo=open-source-initiative&label=License" />
  </a>
</p>

<p align="center"> 
    <img alt="Platform" src="https://img.shields.io/badge/Platform-Android-3DDC84?style=for-the-badge&logo=android&logoColor=white" />
  <img alt="Language" src="https://img.shields.io/badge/Language-Java-007396?style=for-the-badge&logo=java&logoColor=white" />
  <img alt="UI" src="https://img.shields.io/badge/UI-XML-E44D26?style=for-the-badge&logo=html5&logoColor=white" />
  <img alt="Min SDK" src="https://img.shields.io/badge/MinSDK-26-yellow?style=for-the-badge" />
  <img alt="Target SDK" src="https://img.shields.io/badge/TargetSDK-35-blue?style=for-the-badge" />
  <a href="https://crowdin.com/project/ashellyou">
    <img alt="Crowdin" src="https://img.shields.io/badge/Translation-Crowdin-222222?style=for-the-badge&logo=crowdin&logoColor=white"/>
</a>
</p>

</br>

<h2 align="center">Screenshots</h2>
  <div align="center">
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/2.jpeg" width="25%" style="margin:10px" />
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/3.jpeg" width="25%" style="margin:10px" />
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/4.jpeg" width="25%" style="margin:10px" />
  <br/>
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/5.jpeg" width="25%" style="margin:10px" />
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/7.jpeg" width="25%" style="margin:10px" />
  <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/8.jpeg" width="25%" style="margin:10px" />
  <br/>
</div>

</br>

## Features

🎨 **Modern Material Design 3 UI**  
> Experience a clean, smooth, and responsive user interface built with Material You, adapting to your device's wallpaper and theme settings.
</br>

📲 **Execute Commands with Ease**  
> Run ADB shell commands directly on your device using Shizuku, root access, or Wireless Debugging — all without needing a PC.
</br>

🔌 **Control Other Devices**  
> Send ADB commands to other Android devices using OTG cable or Wireless Debugging — perfect for developers and tinkerers.
</br>

📚 **Common ADB Command Examples**  
> Built-in examples help you understand and run useful commands instantly without memorizing syntax.
</br>

🛠️ **Support for Continuous Commands** 
> Seamlessly run long or continuous shell commands like `logcat`, `top`, or `watch` and view live updates without interruptions.
</br>

🔍 **Search in Command Output**  
> Quickly find what you're looking for in the output of your last command using the integrated search functionality.
</br>

📝 **Save Output to File**  
> Save the output of any command to a `.txt` file for future reference or sharing — handy for logs and debugging.
</br>

📤 **Share Output Instantly**  
> One-tap sharing lets you send your output to other apps like Notes, Gmail, or Telegram.
</br>

📑 **Bookmark Commands**  
> Save frequently used commands to bookmarks so you can run them again with a single tap.
</br>

🌑 **AMOLED-Friendly Dark Theme**  
> Includes a sleek dark mode designed to save battery and look great on AMOLED screens.
</br>

🎉 **Packed with Extras**  
> Tons of small but useful features to enhance your productivity and make ADB power-user workflows smoother.

</br>

## Requirements

> * A working **[Shizuku](https://shizuku.rikka.app/)** environment or **root access**
> * Shizuku/Root is **not required** when executing ADB commands on **other devices** using **OTG** or **Wireless Debugging**

<br/>

>[!CAUTION]
>
> Using **aShell You** requires basic knowledge of `ADB/Linux commands`.
>**aShell You** is **not responsible** for any harm caused to your device by improper use of ADB commands

<br/>

>[!TIP]
>
> Please visit our **[Wiki](https://github.com/DP-Hridayan/aShellYou/wiki)** for instructions/setup-guides

</br>

## Resources & Links

<p align="start">
  <a href="https://github.com/DP-Hridayan/aShellYou/releases/latest/">
    <img src="assets/github.png" width="130" alt="GitHub" />
  </a>
  &nbsp;&nbsp;
  <a href="https://apt.izzysoft.de/fdroid/index/apk/in.hridayan.ashell">
    <img src="assets/izzy.png" width="130" alt="F-Droid" />
  </a>
  <br/><br/>
  <a href="https://t.me/aShellYou">
    <img src="assets/telegram.png" width="180" alt="Join Telegram" />
  </a>
  <br/><br/>
  <a href="https://www.buymeacoffee.com/Hridayan">
    <img src="https://github.com/DP-Hridayan/aShellYou/assets/157479796/d0ad79e4-a19e-4686-9f30-dc1cb1e85168" width="200" alt="Buy Me a Coffee" />
  </a></p>

  </br>

## Translations

<p align="start">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="docs/translations-dark.svg?ts=1756774590">
    <source media="(prefers-color-scheme: light)" srcset="docs/translations-light.svg?ts=1756774590">
    <img src="translations-light.svg" alt="Translation Progress" />
  </picture>
</p>

>[!NOTE]
>
> Help us make this project accessible to more people by contributing translations on **[Crowdin](https://crowdin.com/project/ashellyou)**
>
> Thanks to our Crowdin [translators](docs/translators.md)

</br>

## Task list

<table align="start" style="border-collapse: collapse; margin-top: 20px;">
  <tr>
    <th style="padding: 8px; border: 1px solid #ddd; text-align: left;">Task</th>
    <th style="padding: 8px; border: 1px solid #ddd; text-align: left;">Status</th>
  </tr>
  <tr>
    <td style="padding: 8px; border: 1px solid #ddd;">Wifi ADB Feature</td>
    <td style="padding: 8px; border: 1px solid #ddd; color: green;">✅ Done</td>
  </tr>
  <tr>
    <td style="padding: 8px; border: 1px solid #ddd;">Implement root shell</td>
    <td style="padding: 8px; border: 1px solid #ddd; color: green;">✅ Done</td>
  </tr>
  <tr>
    <td style="padding: 8px; border: 1px solid #ddd;">Migrate to kotlin</td>
    <td style="padding: 8px; border: 1px solid #ddd; color: green;">⏺️ In progress</td>
  </tr>
  <tr>
    <td style="padding: 8px; border: 1px solid #ddd;">Proper localization</td>
    <td style="padding: 8px; border: 1px solid #ddd; color: gray;">⬜ To Do</td>
  </tr>
  <tr>
    <td style="padding: 8px; border: 1px solid #ddd;">Fix scripts execution</td>
    <td style="padding: 8px; border: 1px solid #ddd; color: gray;">⬜ To Do</td>
  </tr>
  <tr>
    <td style="padding: 8px; border: 1px solid #ddd;">Add Fastboot</td>
    <td style="padding: 8px; border: 1px solid #ddd; color: gray;">⬜ To Do</td>
  </tr>
</table>

<br/>

## Star history

<a href="https://star-history.com/#DP-Hridayan/aShellYou&Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=DP-Hridayan/aShellYou&type=Timeline&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=DP-Hridayan/aShellYou&type=Date" />
   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=DP-Hridayan/aShellYou&type=Timeline" />
 </picture>
</a>

<br></br>

## License

```
Designed and developed by DP Hridayan @2024
This project is licensed under the GNU General Public License v3.0
```
>[!NOTE]
>
>Full license copy [here](LICENSE.md)

</br>

## Contributors
<a href="https://github.com/dp-hridayan/ashellyou/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=dp-hridayan/ashellyou" />
</a>
</br>