V Terminal Applications

A professional collection of high-quality terminal applications written in V, designed for productivity, learning, and daily use. Each application is self-contained, tested, and almost production-ready.

Installation Script

The installation script provides a convenient way to set up the V Terminal Applications on your system. It automates the process of installing the V programming language, cloning the repository, building each application, and placing the executables in your ~/bin directory for easy access.

Quick Install (Automated)

Run the following command in your terminal to execute the installation script:

curl -fsSL https://raw.githubusercontent.com/cogrow4/V-Terminal-Apps/refs/heads/master/install.sh | bash

The script will prompt you to confirm installation for each program individually, allowing you to choose which applications to install.

Manual Installation

If you prefer to install manually, follow these step-by-step instructions:

1. Install the V programming language manually: Follow the official installation instructions at V programming language to install V on your system.

2. Clone the repository:

   git clone https://github.com/cogrow4/V-Terminal-Apps
   cd V-Terminal-Apps

3. Build each program: For each application you want to install, navigate to its directory and compile it using V:

   cd <application_name>  # Replace <application_name> with the desired app, e.g., cd tasks
   v <application_name>.v  # This compiles the program into an executable

4. Add executables to PATH: Move the compiled executables to a directory in your PATH (such as ~/bin) and ensure it's accessible:

   mkdir -p ~/bin
   cp <application_name> ~/bin/  # For each built program
   # Add the following to your shell profile (e.g., ~/.bashrc or ~/.zshrc) if ~/bin is not already in PATH:
   # export PATH="$HOME/bin:$PATH"

Available Programs

The following applications are available for installation:

• tasks - Task management system
• calc - Scientific calculator
• notes - Note-taking application
• br - Terminal file browser
• quiz - Interactive quiz game
• cash - Budget tracker
• chat - P2P chat client (WIP)
• pom - Pomodoro timer

🌟 Featured Applications

1. 📝 tasks

A feature-rich task management system with advanced productivity features.

• Smart task management with completion tracking
• Persistent storage with JSON database
• Progress analytics and completion statistics
• Priority system and due date tracking
• Advanced search and filtering capabilities
• Clean, intuitive interface with emoji indicators

2. 🧮 calc

A powerful calculator with scientific and programming capabilities.

• Basic arithmetic (+, -, *, /, ^ for power)
• Scientific functions (sqrt, sin, cos, tan with degree input)
• Programming features (logarithmic, exponential functions)
• Robust error handling for invalid inputs
• Interactive interface with clear instructions
• High precision floating-point calculations

3. 📓 notes ⭐

A comprehensive note-taking application for organized knowledge management.

• Rich text notes with multi-line support
• Full-text search across titles and content
• Timestamp tracking (creation and modification times)
• Category organization and tagging system
• Persistent storage with JSON export
• Markdown-like formatting with clean display

4. 📁 br

A modern terminal file browser with intuitive navigation.

• Directory tree navigation with visual indicators
• File information display (size, permissions, dates)
• Quick file search and filtering
• Responsive interface with keyboard shortcuts
• Bookmark system for frequently accessed directories
• Clean, fast performance optimized for large directories

5. 🎯 quiz

An interactive quiz game with educational and entertainment value.

• Multiple categories (General Knowledge, Science & Technology, Programming)
• Adaptive difficulty (Easy, Medium, Hard with dynamic scoring)
• Score tracking and performance analytics
• Explanatory feedback for learning
• Randomized questions for replay value
• Progress indicators and achievement system

6. 💰 cash

A comprehensive budget tracker with real-time financial monitoring.

• Income and expense tracking with categories
• Real-time budget monitoring with visual alerts
• Financial reports and spending analysis
• Budget limits with percentage tracking
• Advanced search and transaction filtering
• Persistent financial data with JSON storage

7. 💬 chat 🚧 WIP

A peer-to-peer terminal chat client for network messaging.

• P2P networking via IP address configuration
• Multi-user chat rooms with real-time messaging
• User management and connection handling
• TCP-based protocol with JSON message format
• Room-based organization and user discovery
• Low-latency messaging optimized for terminal use

8. ⏰ pom

A Pomodoro productivity timer with advanced session management.

• Customizable intervals (work, short break, long break)
• Session statistics and productivity tracking
• Desktop notifications and visual indicators
• Focus mode with distraction prevention
• Progress analytics and streak tracking
• Flexible configuration for different workflows

Getting Started

Prerequisites

• V programming language installed on your system
• Basic familiarity with terminal/CLI usage

Running the Applications

1. Navigate to the application directory:

   cd v_terminal_apps/<application_name>

2. Run the application:

   v run <application_name>.v

Quick Start Commands

Task Manager:

cd v_terminal_apps/tasks && v run tasks.v

Calculator:

cd v_terminal_apps/calc && v run calc.v

Note Taking:

cd v_terminal_apps/notes && v run notes.v

File Browser:

cd v_terminal_apps/br && v run br.v

Quiz Game:

cd v_terminal_apps/quiz && v run quiz.v

Budget Tracker:

cd v_terminal_apps/cash && v run cash.v

P2P Chat (WIP):

cd v_terminal_apps/chat && v run chat.v

Pomodoro Timer:

cd v_terminal_apps/pom && v run pom.v

Project Statistics

• ** Built with:** V Programming Language
• ** Total Applications:** 8 (7 complete, 1 in development)
• ** Storage:** JSON-based persistence where applicable
• ** Compatibility:** Linux, macOS, Windows, Android
• ** Performance:** Optimized for speed and low resource usage
• ** Quality:** Comprehensive error handling and input validation

🛠️ Technical Features

Core Technologies

• V Standard Library for maximum compatibility
• JSON persistence for data storage
• Cross-platform compatibility (Linux, macOS, Windows)
• Thread-safe operations with proper synchronization
• Error handling with user-friendly messages

Development Practices

• Clean code architecture with modular design
• Comprehensive testing for reliability
• User experience focused with intuitive interfaces
• Performance optimized for terminal environments
• Maintainable codebase with clear documentation

📈 Roadmap

✅ Completed (v1.0)

• Task management system with full CRUD operations
• Scientific calculator with comprehensive functions
• Note-taking application with search capabilities
• Terminal file browser with navigation features
• Interactive quiz game with multiple categories
• Budget tracking with real-time monitoring
• Pomodoro productivity timer with analytics

🚧 In Development (v1.1)

• P2P Chat System - Networked messaging between terminals
• Advanced networking features - Peer discovery and room management
• Enhanced UI/UX - Better visual indicators and interactions
• Plugin system - Extensible architecture for custom tools

🔮 Planned (v2.0)

• Cloud synchronization - Cross-device data sync
• Web interface - Browser-based access
• API endpoints - Integration capabilities
• Advanced analytics - Detailed usage statistics
• Theme system - Customizable appearance
• Internationalization - Multi-language support

🤝 Contributing

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Add comprehensive tests for new functionality
4. Update documentation as needed
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

Development Guidelines

• Follow V coding standards and best practices
• Add comprehensive error handling
• Include clear documentation and comments
• Test on multiple platforms (Linux, macOS, Windows)
• Maintain backward compatibility

📄 License

This project is released into the public domain using The Unlicense. You are free to use, modify, and distribute this software for any purpose without restrictions.

For more information, please refer to https://unlicense.org/

🙏 Acknowledgments

• Built with V programming language
• Inspired by the need for simple, efficient terminal tools
• Focus on usability, performance, and clean interfaces
• Thanks to the V community for excellent tooling and support

---

⭐ Ready to boost your terminal productivity? Start with any of our featured applications above!