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.
This Packages building with github action. You can download it from here
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 -siIf 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.shIf 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.shIf 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
# 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.
With 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.
- If you want to make own package
jsonfile for your purposes, you can check the PACKAGES.md file for more information.
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.
- Search Existing Issues: Before opening a new issue, please check if the issue has already been reported.
- 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).
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!
🗃 ├── 🗎 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