Skip to content

TheJ-Erk400/nala-400

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ Nala: Your Ultimate Package Management Sidekick! โœจ

Nala is a sleek, user-friendly front-end for libapt-pkg, built on the python-apt API. ๐ŸŽฏ
It transforms the often complex apt experience into a clear, colorful, and intuitive workflow, perfect for Linux beginners and seasoned pros alike. ๐Ÿ’ป


Discord Codacy GitLab Donate


๐Ÿ“‹ Table of Contents


๐Ÿ“– Overview

Nala redefines package management with simplicity and clarity! ๐Ÿ˜Ž
By leveraging python-apt, Nala:

  • Filters out redundant apt messages ๐Ÿงน
  • Displays package details in a clean, organized format ๐Ÿ“Š
  • Uses vibrant, color-coded outputs for installs, removals, and upgrades ๐ŸŒˆ

Why Nala?
Itโ€™s perfect for beginners overwhelmed by apt and experts craving a faster, more visually appealing workflow. ๐Ÿš€


๐Ÿ› ๏ธ Installation

Get Nala up and running in minutes! โšก
Check our detailed Installation Wiki for tailored instructions. ๐Ÿ“š

Quick Start:

  1. Install Nala using the wiki instructions. ๐Ÿ“ฆ
  2. Run nala update to sync package lists. ๐Ÿ”„
  3. Manage packages like a pro! ๐ŸŽฎ

๐ŸŽฎ Usage

Nala offers intuitive commands with clear, color-coded feedback (green for installs, red for removals, yellow for upgrades). ๐ŸŒŸ

Update Package Lists ๐Ÿ“‹

Refresh your package index:

nala update

Pro Tip: Run this before installing or upgrading for the latest package data. ๐Ÿ”„


Install Packages ๐Ÿ“ฆ

Install with a colorful summary:

nala install <package-name>

Example:

nala install vim

Nala highlights whatโ€™s being installed, upgraded, or removed. ๐ŸŒˆ


Remove Packages ๐Ÿ—‘๏ธ

Uninstall with a clear breakdown:

nala remove <package-name>

Example:

nala remove vim

Add --purge to remove configuration files:

nala remove --purge vim

Upgrade Packages โฌ†๏ธ

Update all packages to their latest versions:

nala upgrade

Combines nala update with upgrades, showing a color-coded summary. ๐Ÿ› ๏ธ


Search for Packages ๐Ÿ”

Find packages in repositories:

nala search <package-name>

Example:

nala search python

Results are clean and readable. ๐Ÿ“œ


Show Package Details โ„น๏ธ

View package details like versions and dependencies:

nala show <package-name>

Example:

nala show apt

Ideal for pre-installation checks! ๐Ÿ‘€


Clean Up ๐Ÿงน

Free up space by removing cached package files:

nala clean

Remove all cached files, including those still needed:

nala clean --all

Autoremove Unused Packages ๐Ÿ—‘๏ธ

Clean up unused dependencies:

nala autoremove

View Transaction History ๐Ÿ•ฐ๏ธ

Review package management history:

nala history

Undo or redo transactions:

nala history undo <ID>
nala history redo <ID>

Example:

nala history undo 5

Optimize Mirrors ๐ŸŒ

Configure the fastest mirrors (see Fetch):

nala fetch

Quick Tips:

  • Use nala --help for all commands and options. ๐Ÿ“–
  • Combine commands like nala update && nala upgrade for efficiency. โšก
  • Enjoy color-coded outputs for instant clarity! ๐ŸŒˆ

โšก Parallel Downloads

Nalaโ€™s parallel downloads supercharge your experience: ๐ŸŽ๏ธ

  • Downloads 3 packages at once per unique mirror in sources.list. ๐Ÿ“ฅ
  • Alternates mirrors for maximum speed. ๐ŸŒ
  • Skips failed mirrors automatically. ๐Ÿ”„

Note: Nala handles downloading and verification independently of apt. ๐Ÿš€


๐ŸŒ Fetch

Optimize downloads with nala fetch! โšก

  • Detects Debian, Ubuntu, or derivatives like Pop!_OS. ๐Ÿ–ฅ๏ธ
  • Retrieves the full mirror list from your distroโ€™s master repo. ๐Ÿ“‹
  • Tests latency and selects the fastest 3 mirrors (configurable). ๐Ÿ†
  • Updates sources.list with the best mirrors. ๐Ÿ“

Pro Tip: Run nala fetch to boost download speeds instantly! โฑ๏ธ


๐Ÿ“œ History

Track your package management with nala history! ๐Ÿ•ฐ๏ธ

  • Logs every install, remove, or upgrade in /var/lib/nala/history.json with a unique <ID>. ๐Ÿ“‚

  • View transaction summaries with nala history. ๐Ÿ“‹

  • Undo or redo actions:

    nala history undo <ID>
    nala history redo <ID>
  • Clear entries or wipe history:

    nala history clear <ID>
    nala history clear --all

Inspired by dnf, Nalaโ€™s history keeps you in control! ๐ŸŽฎ


๐Ÿš Shell Completions

Nala enhances your shell with seamless completions! ๐ŸŸ

  • Supports Bash, Zsh, and Fish via typer. ๐Ÿ› ๏ธ
  • Install Nala, restart your shell, and enjoy auto-completions. โœจ

๐Ÿ› Bug Reports & Feature Requests

Got a bug or idea? ๐Ÿ’ก Weโ€™re listening!

  • Official Repo: https://gitlab.com/volian/nala ๐Ÿ 
  • File reports or requests on GitLab. ๐Ÿ“ฉ
  • Note: GitHub and Debian Salsa are mirrors; GitLab is the primary hub. ๐Ÿ”—

๐Ÿ’– Donations

Love Nala? Keep the project thriving! ๐ŸŽ
Donate at: https://liberapay.com/Volian-Linux ๐Ÿ’ธ


๐Ÿ“ธ Screenshots

See Nala in action! ๐Ÿ–ผ๏ธ

  • Package installation in progress
  • Fetching mirrors
  • History commands
  • And more!

Visit the official repo for visuals. ๐ŸŒŸ


โญ Star us on Github to support Nala and make package management awesome! ๐Ÿš€


---

โญ **Star us on GitLab** to support Nala and make package management awesome! ๐Ÿš€  

About

NALA-400-- Is APT wrapper for the apt package manager!

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 98.7%
  • Other 1.3%