Skip to content

busy4me/busybox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

277 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

BusyBox πŸ€– by busy4me ℒ️

Automated Virtual Assistant Platform for Linux

Version Status License Platform

Features β€’ Installation β€’ Usage β€’ Documentation β€’ Contributing


πŸ“š Documentation Index (Developer Track)

Document Description
WHITEPAPER.md Start Here β€” White Paper (PL), vision & business model
VISION.md Philosophy, goals, architecture overview, session history
PLAN.md Implementation plan, priorities, open decisions
architecture/ARCHITECTURE.md Deep dive: displays, processes, plugins, config
architecture/AUTH-FLOW.md 6-digit pairing design (OAuth RFC 8628)
process/PROCESS-FLOW.md Step-by-step: installation β†’ runtime β†’ what's on screen
plugins/PLUGINS.md Plugin system, CV engine, writing new plugins
i18n/README.md Multi-language documentation plan (12 languages)
reference/initiv.md initiv installation script reference

πŸ“‹ Overview

BusyBox πŸ€– by busy4me ℒ️ is an open-source automation platform that runs continuously on Linux machines, handling routine online tasks through a virtual assistant. It provides internet-based control via web, smartphone, and tablet interfaces, operating securely behind firewalls without exposed ports.

Built on clean Linux architecture with minimalist code, Busybox offers:

  • πŸ” Encrypted local data storage with firewall protection
  • 🌐 Remote access without port forwarding
  • ⚑ Low resource consumption (minimal storage and memory)
  • 🎯 Click-and-Play accessibility
  • πŸ› οΈ Developer-oriented configuration
  • πŸ“œ Apache v.2 licensed open-source

✨ Features

  • Continuous Automation - Run tasks 24/7 without manual intervention
  • Secure & Private - Encrypted connections and firewall-protected data
  • Platform Agnostic - Works on VMs, dedicated hardware, ARM, Raspberry Pi
  • Social Media Automation - Automated posting, commenting, sharing, and engagement
  • Database Management - Built-in database operations for content management
  • Live Streaming - Stream desktop to multiple platforms
  • Remote Console - SSH access for advanced management
  • Cron Integration - Schedule tasks with flexible timing options

πŸš€ Quick Start

Prerequisites

  • VirtualBox or VMware (for VM installation)
  • Debian-based Linux system (Debian 10+ recommended)
  • Internet connection

Installation

Option 1: Debian 10 Buster (Recommended)

  1. Install minimal Debian 10 Buster in VirtualBox

  2. Run the installation script:

    wget https://raw.githubusercontent.com/busy4me/busybox/main/root/initiv && bash ./initiv install
  3. Wait for browser and login window to appear (several minutes)

  4. Enter your credentials - the system will simulate natural user behavior

  5. Your host becomes operational

Option 2: Debian 8 Jessie (Legacy)

wget https://raw.githubusercontent.com/busy4me/busybox/main/root/init-0 && bash ./init-0

πŸ“– Usage

Quick Examples

Social Media Operations:

busy --like="https://socialportal.com/fanpage/post" :0  # Like a post
busy --follow="https://socialportal.com/profile" :2     # Follow profile
busy --comment="Great!" --url="socialportal.com/post"   # Comment

Content Publishing:

busy --post="database.table.record" :5  # Publish from database
busy --share="https://example.com" :1   # Share content

Database Operations:

busy --db=show                          # Show all tables
busy --db=show --table="fb_posts"       # Show table records
busy --db=add --table="fb_posts" --data="content"  # Add record

System Operations:

busy --restart :5       # Restart display :5
busy --cron=status      # Check cron status
busy --clip-clear       # Clear clipboard

πŸ“š Full documentation: See Usage Guide for complete command reference.

πŸ—„οΈ Database Tables

Busybox uses local databases to manage content and platform interactions:

  • Facebook: fb_user, fb_posts, fb_groups, fb_pages, fb_plan
  • YouTube: yo_user
  • Instagram: in_user
  • General: socialmedia (shared data)

πŸ“š Full documentation: See Database Tables for detailed schema and operations.

πŸ” Remote Access

Access your Busybox instance via SSH:

ssh 192.168.1.23 -p 22
su busybox

πŸ“š Documentation: See Usage Guide for advanced access methods.

πŸ—οΈ Architecture

Deployment Models

Classic User Flow:

User β†’ Social Media β†’ Advertisement β†’ Control

With Busybox:

User (iPhone/Android/Web) β†’ Busybox Host β†’ Social Media
                          ↓
                    Status Reporting

System Users

  • busybox - Executes user commands and shell scripts (DISPLAY :1)
  • root - System-level operations
  • admin - Reserved
  • vi - Reserved

Platform Support

  • βœ… Virtual Machines (VMware, VirtualBox, QEMU)
  • βœ… Dedicated Hardware (x86/x64 PCs)
  • βœ… ARM Devices (Raspberry Pi, etc.)
  • βœ… Headless Systems

🎯 Design Goals

  1. Clean Implementation - Simple, maintainable Linux distribution
  2. Minimalist Architecture - Reduced code complexity
  3. Resource Efficiency - Low storage and memory footprint
  4. Independence - Standalone operation without external dependencies
  5. Automation - Automatic process management
  6. Security - High-standard encrypted internet connections

πŸ› οΈ Update System

Update Busybox components:

update --full              # Update all files
update --binaries          # Update binary files only
update --busy              # Update busy executable
update -h                  # Display help

πŸ“š Full documentation: See Usage Guide for all update options.

πŸ“š Documentation

Local Documentation

Online Resources

For additional documentation, visit the Busybox Wiki.

🀝 Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.

See docs/TEAMS.md for team structure and active tasks.

πŸ“„ License

BusyBox πŸ€– by busy4me ℒ️ is open-source software licensed under the Apache License 2.0.

Copyright Β© busy4me ℒ️
Licensed under Apache License v.2

See LICENSE file for details.

🌐 Links


Made with ❀️ by BusyBox πŸ€– by busy4me ℒ️

⭐ Star us on GitHub if you find this project useful!

About

πŸ™ busy commands set - to manage "Busybox" 🌐

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors