ADBenQ

Version: 0.2.4-alpha

---

Table of Contents

• ℹ️ About
• 📋 Requirements
• 🛠️ Installation
  • 🐍 Using Pip
  • 📦 Using Tarball (MacOS)
  • 🐧 Arch Linux and derivatives (AUR)
    • 💻 Using paru/yay
    • 🔧 Manually
• 🚀 Usage
• 📚 Documentation
  • 🌟 Highlight of the Wiki
• 🤝 Contributing
• 📜 License
• 👥 Contributors
• 🧑‍💻 Author

ℹ️ About

Welcome to ADBenQ! 🎉

This is a desktop application built using PySide6 (Qt for Python) to control University BenQ smart TVs via ADB (Android Debug Bridge).

Note

But hey, let's be real: the true goal of this project is to learn Qt and become a future app developer! 🚀 It’s all about the journey of improving skills while building something fun and practical.

Why ADBenQ?

• 🖥️ Seamlessly control smart TVs.
• 🛠️ Built with PySide6, mixing UI design and functionality.
• 📚 Detailed documentation to guide you through the app.

📋 Requirements

To run ADBenQ, you'll need:

• Python 3.9 or later.
• ADB installed on your system.
• Scrcpy installed on your system.

Warning

Make sure ADB and Scrcpy are accessible from your system's PATH!

🛠️ Installation

🐍 Using Pip

1. Clone the repository:

   git clone https://github.com/Zarox28/ADBenQ.git
   cd ADBenQ

2. Install dependencies:

   pip install -r requirements.txt

3. Run the app:

   python main.py

4. (Optional) Create a standalone executable:

   pip install pyinstaller
   pyinstaller ADBenQ.spec

   The executable will be located in the dist folder.

📦 Using Tarball (MacOS)

1. Download the latest release from the Releases page.

2. Extract the tarball:

   tar -xvf ADBenQ-macos.tar.gz
   cd ADBenQ

3. Run the app:

    ./ADBenQ

🐧 Arch Linux and derivatives (AUR)

💻 Using paru/yay

paru -S adbenq-git

or

yay -S adbenq-git

🔧 Manually

1. Clone the build scripts from the aur or download snapshot

   git clone https://aur.archlinux.org/adbenq-git.git

2. Open a terminal inside the cloned directory

3. Run the build scrips using makepkg

   makepkg -si

🚀 Usage

Follow these steps to use ADBenQ:

1. 🚀 Launch the application.
2. 📡 Connect your BenQ TV to the same network as your computer.
3. 🖥️ Enter the TV's IP address in the app interface (if it's not already connected).
4. 🎮 Explore the control options.
5. 🎉 Enjoy the power of controlling your TV from your computer! 🚀

📚 Documentation

Looking for more details about ADBenQ’s features or troubleshooting advice? We've got you covered!

🌟 Highlight of the Wiki:

• General tab - Learn how to connect your TV and general purpose of the app. 📺
• Media Tab - Control media playback on your TV. 🎥

Check out the Wiki to make the most out of ADBenQ! 🚀

🤝 Contributing

Contributions are welcome! Open an issue or create a pull request to share your ideas. 🤝

📜 License

This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.

👥 Contributors

• @0x4c756e61 (Luna) - Provided the package for Arch Linux and derivatives.

🧑‍💻 Author

• @Zarox28