Virtual CANDY "VCANDY" 🖥️

It's a package manager for Linux distributions. Handles the installation and removal of packages with a simple command-line interface or terminal UI. Also includes a JSON file for package information and a script for building packages for different distributions.

📦 Pre Builded Packages

This Packages building with github action. You can download it from here

🏗️ Build From Github Repository and Testing

Arch

The initial installation of vcandy can be done by cloning the PKGBUILD and building with makepkg:

pacman -S --needed git
git clone https://github.com/Hakanbaban53/Virtual-CANDY.git
cd Virtual-CANDY/test/scripts
makepkg -si

If you want to do all of this at once, we can chain the commands like so:

pacman -S --needed git && git clone https://github.com/Hakanbaban53/Virtual-CANDY.git && cd cd Virtual-CANDY/test/scripts && makepkg -si

Debian or Ubuntu

To install Candy on Debian or Ubuntu, it is sufficient to first clone this repository and make the build_deb_package.sh script executable and run it. It will automatically create and install the debian package:

apt install git
git clone https://github.com/Hakanbaban53/Virtual-CANDY.git
cd Virtual-CANDY/test/scripts
chmod +x ./build_deb_package.sh
./build_deb_package.sh

If you want to do all of this at once, we can chain the commands like so:

apt install git && git clone https://github.com/Hakanbaban53/Virtual-CANDY.git && cd Virtual-CANDY/test/scripts && chmod +x ./build_deb_package.sh && ./build_deb_package.sh

Fedora

To install Candy on Fedora, it is sufficient to first clone this repository and make the build_rpm_package.sh script executable and run it. It will automatically create and install the rpm package:

dnf install git
git clone https://github.com/Hakanbaban53/Virtual-CANDY.git
cd Virtual-CANDY/test/scripts
chmod +x ./build_rpm_package.sh
./build_rpm_package.sh

If you want to do all of this at once, we can chain the commands like so:

dnf install git && git clone https://github.com/Hakanbaban53/Virtual-CANDY.git && cd Virtual-CANDY/test/scripts && chmod +x ./build_rpm_package.sh && ./build_rpm_package.sh

- 🗑️ If you want to remove the package:

# Arch
pacman -Rsc vcandy

# Debian or Ubuntu
apt remove vcandy

# Fedora
dnf remove vcany

• Also you can check the TEST.md file for more information.

⚙️ Usage

With Arguments

Arguments

Argument	Description	CLI	TUI
-a, --action	Specifies the action to perform. Choices are 'install' or 'remove'. Default is 'install'.	✅	❌
-j, --json	Specifies the JSON file to use for package information. Defaults to predefined.	✅	✅
-u, --url	Specifies the URL to use for package information. Overrides the JSON file. Its need the use with -r or --refresh.	✅	✅
-r, --refresh	Refreshes the JSON data regardless of its file age. Useful to get the latest package information.	✅	✅
-v, --verbose	Enables verbose output for detailed information during execution. Helps with debugging or understanding process details.	✅	✅
-d, --dry-run	Performs a dry run of the command without making any changes. Useful for testing what would be done.	✅	✅
-l, --list	Lists available packages for the specified distribution. Useful for checking what packages are available.	✅	❌
--distribution	Specifies the Linux distribution to use. Defaults to auto-detecting the distribution.	✅	✅
--all	Installs or removes all available packages for the specified distribution.	✅	❌
packages	List of packages to install or remove.	✅	❌
-v, --version	Displays the version of VCANDY.	✅	✅
-h, --help	Displays the help message with a list of available arguments.	✅	✅

• Install specific packages:

  vcand -a install package1 package2

• Remove specific packages:

  vcand -a remove package1 package2

• Refresh JSON data:

  vcand -r

• Enable verbose output:

  vcand -v -a install package1

• Perform a dry run:

  vcand -d -a install package1

• List available packages:

  vcand -l --distribution ubuntu

• Install or remove all available packages:

  vcand --all -a install

• Specify distribution:

  vcand --distribution ubuntu -a install package1

And one more thing. Arguments are case-sensitive. You need to give the package names as specified below:

With Terminal UI

If you install the in your pc you can use in the terminal vcandy or you can use "python app.py". Terminal UI start with default. Basic terminal UI for installer.

Use Left/Right arrow key select "yes" or "no". Press "Enter" key for confirm..

Use Up/Down arrow key move each other packager. Use "Tab" key Select/Unselect packages. Press Enter key the confirm packages.

Use "Ctrl + H" key for help.

📦 Package Managing

• If you want to make own package json file for your purposes, you can check the PACKAGES.md file for more information.

🚀 Issues

If you encounter any issues or have suggestions for improvements, please feel free to open an issue on our GitHub Issues page. We welcome contributions and feedback from the community to make VCANDY better.

❓ How to Report an Issue

1. Search Existing Issues: Before opening a new issue, please check if the issue has already been reported.
2. Create a New Issue: If your issue is not listed, create a new issue and provide detailed information.

• Title: A clear and descriptive title.
• Description: A detailed description of the issue, including steps to reproduce, expected behavior, and actual behavior.
• Screenshots: If applicable, include screenshots to help illustrate the issue.
• Environment: Specify the environment in which the issue occurs (e.g., Distribution, VCANDY version).

🌟 Feature Requests

We also welcome feature requests! If you have an idea for a new feature or an improvement, please open an issue and label it as a feature request. Provide as much detail as possible to help us understand your suggestion.

Thank you for helping us improve VCANDY!

📂 Folder structure

🗃
├── 🗎 README.md
├── 🗎 LICENSE
├── 🖿 assets
│   └── 🖻 preview images
├── 🖿 docs
│   ├── 🗎 PACKAGES.md
│   └── 🗎 TEST.md
├── 🖿 packages
│   └── 🗎 packages.json
├── 🖿 src
│   ├── ⚙️ app.py
│   ├── 🖿 TUI
│   │   ├── 🖿 core
│   │   │   ├── 🖿 components
│   │   │   │   ├── 🗎 __app_selector__.py
│   │   │   │   ├── 🗎 __footer__.py
│   │   │   │   ├── 🗎 __header__.py
│   │   │   │   ├── 🗎 __modal_win__.py
│   │   │   │   ├── 🗎 __print_apps__.py
│   │   │   │   └── 🗎 __selections__.py
│   │   │   ├── 🖿 static
│   │   │   │   ├── 🗎 __color_init__.py
│   │   │   │   └── 🗎 __data__.py
│   │   │   └── 🖿 utils
│   │   │       ├── 🗎 __check_connection__.py
│   │   │       ├── 🗎 __clean_line__.py
│   │   │       ├── 🗎 __clear_midde_section__.py
│   │   │       ├── 🗎 __errors_.py
│   │   │       ├── 🗎 __helper_keys__.py
│   │   │       ├── 🗎 __input__.py
│   │   │       └── 🗎 __resize_handler__.py
│   │   └── 🗎 __terminal_UI__.py
│   ├── 🖿 core
│   │   ├── 🗎 __check_repository_connection__.py
│   │   ├── 🗎 __command_handler__.py
│   │   ├── 🗎 __constants__.py
│   │   ├── 🗎 __get_os_package_manager__.py
│   │   ├── 🗎 __get_packages_data__.py
│   │   ├── 🗎 __linux_system__.py
│   │   ├── 🗎 __logging_manager__.py
│   │   ├── 🖿 package_handlers
│   │   │   ├── 🗎 __aur__.py
│   │   │   ├── 🗎 __flatpak__.py
│   │   │   ├── 🗎 __local__.py
│   │   │   ├── 🗎 __normal__.py
│   │   │   └── 🗎 __special__.py
│   │   └── 🗎 __pack_type_handler__.py
│   └── 🖿 utils
│       └── 🖿 cli
│           └── 🗎 __arguments__.py
└── 🖿 test
    ├── 🖿 scripts
    │   ├── 🗎 build_deb_package.sh
    │   ├── 🗎 build_rpm_package.sh
    │   └── 🗎 PKGBUILD
    └── 🗎 test_app.py

Hakan İSMAİL 💙