Anode MCU Manager

---

       

anodemcu is a premium, interactive TUI (Terminal User Interface) designed to simplify microcontroller development. It transforms the command-line tools into a vibrant, intuitive experience, allowing you to manage boards, ports, libraries, and projects across multiple ecosystems.

[!TIP] Perfect for developers who live in the terminal and want a high-speed, "no-nonsense" workflow for compiling and uploading code.

Features

• Multi-Platform Support: Seamlessly work with Arduino CLI, ESP-IDF, and PlatformIO projects.
• Auto-Detection & Ambiguity Resolution: Automatically detects the project type based on files. If multiple configurations exist (e.g. both CMakeLists.txt and platformio.ini), it prompts you to select your preferred platform and saves the choice.
• ESP-IDF Auto-Sourcing: Automatically locates and sources the ESP-IDF export.sh script if it's not active in the current shell environment.
• Rich Terminal UI: Vibrant color-coded interface with a live dashboard header.
• Fuzzy Search Integration: Powered by fzf for near-instant selection of boards, ports, and libraries.
• Smart Project Management: Create, select, and edit projects (Neovim support) from a single menu, starting automatically in the current directory if it is a valid project.
• Safe Uploads: Automatic project backups before every upload (keeps the last 5 versions).
• Integrated Monitor: Quick access to the serial monitor for real-time debugging.
• Operation Logging: Complete history of your actions with automatic log rotation.
• Native Arch Linux Support: Available directly via the AUR.

---

Installation

Arch Linux (AUR)

If you are on Arch, this is the recommended way:

yay -S anodemcu

Global Installation (Any Linux/macOS)

Clone the repository and run the automated installer:

git clone https://github.com/abod8639/anodemcu.git
cd anodemcu
./install.sh

This will install the tool to ~/.local/bin/anodemcu and set up a convenient anode alias.

Manual Install

chmod +x anodemcu
# Run locally
./anodemcu

---

Prerequisites

Arch Linux

yay -S arduino-cli fzf jq neovim

Debian/Ubuntu

sudo apt update
sudo apt install arduino-cli fzf jq neovim

Fedora

sudo dnf install arduino-cli fzf jq neovim

---

How to Use

Simply type anode (if installed globally) or ./anodemcu to open the main menu.

Keyboard Shortcuts & Platform-Specific Actions

Use these single-key triggers for a lightning-fast workflow:

---

Configuration

The tool maintains its state automatically, but you can customize defaults by editing your local configuration or the script header:

DEFAULT_FQBN="esp32:esp32:esp32"
DEFAULT_PORT="/dev/ttyACM1"
SKETCH_DIR="$HOME/Arduino"

Troubleshooting

• Upload Failed? Check your USB cable and ensure the port (P) is correctly selected.
• Library Missing? Use the Library Manager (R) to search and install missing dependencies.
• Permission Denied? Ensure your user is in the uucp or dialout group (on Linux).

---

📜 License & Acknowledgments

Distributed under the MIT License. See LICENSE for more information.

Built with ❤️ by Dexter