reptor-tasks 🦖

A lightweight, local Command-Line Interface (CLI) task manager written in C++. Track your daily to-do list directly from your favorite terminal environment with retro visual flair and background audio tracks.

 ██████╗ ███████╗██████╗ ████████╗██████╗ ██████╗     ████████╗█████╗ ███████╗██╗  ██╗███████╗
██╔══██╗██╔════╝██╔══██╗╚══██╔══╝██╔══██╗██╔══██╗    ╚══██╔══╝██╔══██╗██╔════╝██║ ██╔╝██╔════╝
██████╔╝█████╗  ██████╔╝   ██║   ██║  ██║██████╔╝       ██║   ███████║███████╗█████╔╝ ███████╗
██╔══██╗██╔══╝  ██╔═══╝    ██║   ██║  ██║██╔══██╗       ██║   ██╔══██║╚════██║██╔═██╗ ╚════██║
██║  ██║███████╗██║        ██║   ╚██████╔╝██║  ██║      ██║   ██║  ██║███████║██║  ██╗███████║
╚═╝  ╚═╝╚══════╝╚═╝        ╚═╝    ╚═════╝ ╚═╝  ╚═╝      ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚══════╝

                               Version 1.0.0 by Owenb135/Owen0963

🚀 Features

• Custom Splash Animation: Highly stylized retro console startup screen.
• Persistent Task Engine: Automatically saves your tasks locally to tasks.txt across runtime sessions.
• Seamless Audio Integration: Cross-platform background loop driver natively matching your audio subsystems.
• Cloud Safety Checks: Instantly bypasses hardware audio engine allocations when operating within limited sandbox cloud platforms like GitHub Codespaces.
• Orphan-Process Prevention: Clean dynamic lifecycle scripting prevents music loops from lingering in your operating system memory after program closure.
• Saved Tasks: Reptor Tasks will save your tasks, so if you don't finish them one day; you can the next.

🛠️ System Requirements & Prerequisites

🐧 Linux Systems (Ubuntu / Debian / Arch)

To enjoy the background theme natively outside cloud sandboxes, ensure a local platform audio server pipeline utility is installed:

# For PulseAudio setups
sudo apt install pulseaudio-utils

# For ALSA configurations
sudo apt install alsa-utils

⚙️ Build & Installation

Ensure you have a modern C++ compiler (g++ or clang) supporting the standard C++11 implementation sequence or newer.

1. Clone the project workspace:

   git clone https://github.com/owenb135/reptor-tasks
   cd Reptor-Tasks

2. Compile the binary executable:

   g++ -std=c++11 main.cpp -o main

3. Deploy track loops: Ensure a local baseline file named theme.wav (or theme.mp3 depending on choice of player) resides in the exact directory where the execution call is targeted.

💻 Console Operation

Execute the system direct from your console shell container:

./main

Once the introductory timer sequence clears, interface with the application menu directly using standard inline system arguments:

1. Insert an Activity Entry

Enter command: add Finish writing my systems automation scripts
➕ Task added!

2. Check Active Records

Enter command: list

===============================
         🦖 REPTOR TASKS       
===============================
[1] Finish writing my systems automation scripts

3. Clear Target Entry

Enter command: done 1
✔ Completed: Finish writing my systems automation scripts

4. Terminate Runtime Execution

Enter command: exit
Goodbye!