@@ Line 1: / Line 1: @@
+__TOC__
-Pamac is a GUI Software Management (or Package Management) program that can be used instead of, or in addition to, using [[pacman]] in the terminal. Pamac is the default choice for the XFCE and Gnome Manjaro flavours. (The default Graphical Software Manager for the KDE flavour is [[Octopi]])
-[[File:pamac-updater-088.png|thumb|left|200px]]
-The '''Pamac Updater''' will automatically check and notify you of any available system updates.
+=Overview=
-To install updates when listed, simply click the '''Apply''' button.
+Pamac is Manjaro's Package Manager.  It is based on libalpm with AUR and Appstream support.  It's focuses on providing an easy to use interface while still providing a powerful set of features.
-<br clear="all" />
-[[File:pamac-manager-088.png|thumb|left|375px]]
+[[File:Pamac-gtk-main.png|center|800px]]
-The '''Pamac Manager''' is a very simple, yet powerful tool to add and remove software packages (applications) from your system. This can be found in the '''System''' menu category, or in Openbox, via Synapse or the desktop menu.
+=Installing Pamac=
-Upon launching, it will automatically check the official Manjaro Repositories for new and updated software. Once complete, simply enter the name or short description of what you want to install or remove, and click the '''Find''' button.
+Pamac is pre-installed on many Manjaro Editions but if your system does not have it can be easily installed.  Pamac comes in several different packages:
+* {{ic|pamac-gtk}} - The GTK version of pamac.  Includes a tray icon for many desktops.
+* {{ic|pamac-qt}} - The QT version of pamac. Experminetal.
+* {{ic|pamac-cli}} - The command line version of pamac.
+* {{ic|pamac-tray-appindicator}} - A tray icon for KDE plasma
-When you want to search AUR (=[[Arch User Repository]]), tick the '''Search in AUR''' and press the '''Find''' button.
-All installed and available software matching your search will then be displayed on the right. Click the name of any result to see more information about it immediately below.
+These packages can be installed using pacman.  For example, to install the GTK version, you can use the command:
-<br clear="all" />
+ sudo pacman -Syu pamac-gtk
-[[File:pamac-manager2-088.png|thumb|left|375px]]
+{{tip|Both the GTK and QT Pamac packages will automatically install the CLI version as well}}
-A checkbox next to the package name will indicate whether it is installed or not.
-* '''To install a package''', double-click the adjacent checkbox to mark it.
+=Using the Pamac GUI=
-* '''To remove an installed package''', double-click the adjacent checkbox to clear it.
-Once package boxes have been marked and/or cleared, you may undertake more searches before clicking the Apply button to conform your choice(s). It really is that simple!
+==Installing Software==
-<br clear="all" />
-<pre>
+[[File:Pamac-gtk-optional-deps.png|left|thumb|400px]]
-~ >>> pamac -h
-Available actions:
-  pamac --version
+To install packages simply check check the box next to the packages.  Once you have selected all the packages all the packages you want to install, click the Apply button at the bottom of the page.
-  pamac --help,-h      [action]
-   pamac checkupdates   [options]
-  pamac search         [options] <package(s)>
+If any of the packages have optional dependencies(packages that enable additional functionality) you will see a window like the one to the left which allows to select the ones you would like to install.
-   pamac info           [options] <package(s)>
+<div style="clear: both"></div>
-   pamac list           [options] <package(s)>
+[[File:Pamac-gtk-transaction-summary.png|left|thumb|400px]]
-   pamac install        [options] <package(s)>
-  pamac reinstall      [options] <package(s)>
-  pamac build          [options] <package(s)>
+After you have selected optional dependencies, you should see a windows similar to the one pictured on the left.  This lists all the packages that will be installed, upgraded or removed by the action.  Once you have reviewed the list, press the Apply button to install the packages.
-  pamac remove         [options] <package(s)>
-  pamac update,upgrade [options] <package(s)>
-</pre>
+You may notice this list has more packages than you selected in the GUI.  This is because many packages also have dependencies which are packages that must be installed in order for the software you selected to function properly.  You may also notice that packages are being removed even though you didn't select any packages to remove.  This is happening in the example to the left where you can see {{ic|clutter}} and {{ic|cogl}} are being removed.  They are being removed because they conflict with {{ic|deepin-clutter}} and {{ic|deepin-cogl}} which provide the same functionality.
+<div style="clear: both"></div>
+==Removing Software==
+[[File:Pamac-gtk-remove-summary.png|left|thumb|400px]]
+Removing software is as simple as unchecking the packages you want to remove and clicking the Apply button at the bottom of the page.
+Once you do you should see a screen similar to the one on the left which lists all the packages that are about to be removed.  You may notice this list contains more packages than you selected.  This is because when you remove a package that other packages depend on, those packages are also removed.
+{{warning|It is extremely important to carefully review the Transaction Summary before removing accepting the package removal.  Some packages have many packages which depend on them and you don't want to inadvertently remove your whole Desktop Environment}}
+<div style="clear: both"></div>
+==Preferences==
+You can access the preferences by clicking on the three dots in the upper right corner and selecting preferences.
+[[File:Pamac-gtk-preferences-general.png|left|thumb|400px]]
+The General tab of preferences contains several settings, most of which are self explanatory.
+* Remove unrequired dependencies - This removes dependencies which are no longer required by any package
+* Check available disk space - Checks to ensure you have sufficient disk space available before downloading and installing packages
+* Maximum parallel downloads - The number of concurrent downloads allowed
+* Enable downgrade - This allows packages to be downgraded as well as upgraded.  This is important when [[Switching_Branches|switching branches]].
+* Check for updates - Disabling this will stop Pamac from looking for updates.  In most cases, turning this off on a [[The Rolling Release Development Model|rolling release]] distro like Manjaro is a bad idea.
+* Ignore updates for - This is a list of packages that you don't want to be upgraded.  This is inherently dangerous practice and should only be used by advanced users.
+{{warning|Ignoring updates for individual packages will leave you in an unsupported "partial upgrade" state.  It is common for innocuous looking ignored packages to leave your system unbootable}}
+<div style="clear: both"></div>
+[[File:Pamac-gtk-preferences-aur.png|left|thumb|400px]]
+Pamac is also capable of installing and upgrading packages from the [[Arch User Repository|Arch User Repository(AUR)]].  Please carefully read the considerations in the [[Arch User Repository|linked page]] prior to enabling support for AUR.
+If you enable AUR support, it is usually wise to also select, "Check for updates from AUR" so software you install from AUR won't become outdated.
+Checking for "development package" updates will allow updates on *-git packages which are built from the latest source code to also be updated.
+The "Build directory" is where AUR packages will be built.  Using "tmp" usually will provide the best performance but very large packages may fail to build.  In this case, select somewhere with more available space.
+<div style="clear: both"></div>
+[[File:Pamac-gtk-preferences-cache.png|left|thumb|400px]]
+When Pamac installs packages, it keeps a copy of all the old packages you have downloaded.  This cache can be very useful if you have to download packages in an emergency.  However, left unchecked, this cache will grow very large over time.  These preferences allow your cache to be automatically managed based on your preferences.
+The first option allows you to set a number for how many copies of each package are retained.  In other words, if you have downloaded 25 versions of firefox over the life of your install and you set this number to "3", only the most recent 3 versions will be retained.  Unless you are very short on disk space, it is recommended to set this to at least 2.
+By selecting "Remove only the versions of uninstalled packages" pamac will retain all versions of packages you still have installed.
+<div style="clear: both"></div>
+=Using the Pamac CLI=
+Pamac also includes a fully functional CLI for when you don't have a functional GUI or for those that prefer to manager packages that way.
+{{warning|Never use sudo with pamac.  It will ask for escalated rights if it needs them}}
+==Locating and Installing Packages==
+To search for available packages you can use the command {{ic|pamac search}}.  For example, to search the repos for packages containing the word smplayer:
+<pre>pamac search smplayer
+smplayer                                                                                                                                                                                                                                                                                   [Installed] 19.5.0-1    community
+  Media player with built-in codecs that can play virtually all video and audio formats
+smplayer-skins                                                                                                                                                                                                                                                                             [Installed] 1:15.2.0-2  community
+   Skins for SMPlayer
+smplayer-themes                                                                                                                                                                                                                                                                            [Installed] 1:18.6.0-1  community
+   Themes for SMPlayer</pre>
+As you can see, this will also show you which packages are already installed.  If you would like to search both the repos and [[Arch_User_Repository|AUR]] you add {{ic|-a}} like this:
+<pre>pamac search -a smplayer
+smplayer                                                                                                                                                                                                                                                                              [Installed] 19.5.0-1         community
+  Media player with built-in codecs that can play virtually all video and audio formats
+smplayer-skins                                                                                                                                                                                                                                                                        [Installed] 1:15.2.0-2       community
+   Skins for SMPlayer
+smplayer-themes                                                                                                                                                                                                                                                                       [Installed] 1:18.6.0-1       community
+  Themes for SMPlayer
+papirus-smplayer-theme-git                                                                                                                                                                                                                                                                        20181024-2       AUR
+  Papirus theme for SMPlayer (git version)
+smplayer-svn                                                                                                                                                                                                                                                                                      17.12.0.r8852-1  AUR
+  Advanced front-end for MPlayer/MPV
+smplayer-svn-notitlebar                                                                                                                                                                                                                                                                           18.3.0.r8982M-1  AUR
+  Advanced front-end for MPlayer/MPV + Patch to disable titlebar in compact mode
+smplayer-skins-svn                                                                                                                                                                                                                                                                                15.2.0.r8852-1   AUR
+  Skins for SMPlayer
+smplayer-themes-svn                                                                                                                                                                                                                                                                               17.3.0.r8852-1   AUR
+  Themes for SMPlayer
+smplayer-qt4                                                                                                                                                                                                                                                                                      18.5.0-1         AUR
+   Complete front-end for MPlayer/MPV (Qt4)
+rosa-media-player-plugin                                                                                                                                                                                                                                                                          1.0-2            AUR
+   The new multimedia player(based on SMPlayer) with clean and elegant UI (mozilla plugin only).
+smplayer-theme-faenza (Out of Date: 09/15/2017)                                                                                                                                                                                                                                                   2-2              AUR
+  Normal, dark and silver faenza theme for smplayer.
+umplayer                                                                                                                                                                                                                                                                                          0.98.2-2         AUR
+  An alternative to SMPlayer</pre>
+Once you have identified the packages you wish to install you can install them with command {{ic|pamac install}}.  For example, if we wanted to install {{ic|smplayer}} and {{ic|smplayer-themes}} we could use the command:
+ pamac install smplayer smplayer-themes
+{{tip|When using install pamac will check to see if packages are installed and only install the ones not already installed}}
+If you want to install packages from [[Arch_User_Repository|AUR]] you use the command {{ic|pamac build}}.  Sticking with the above example, if you decided you wanted to install {{ic|umplayer}} instead you could the command:
+ pamac build umplayer
+==Removing Packages==
+The command {{ic|pamac remove}} can be used to uninstall packages installed from the repos or [[Arch_User_Repository|AUR]].  For example if you wanted to remove all the packages installed above you could use the command:
+ pamac remove smplayer smplayer-themes umplayer
+{{warning|It is extremely important to carefully review the list of packages pamac presents before confirming.  Some packages have many packages which depend on them and you don't want to inadvertently remove your whole Desktop Environment}}
+==Identifying Installed Packages==
+To display a list of all installed packages you can use the command:
+ pamac list -i
+==Displaying Detailed Package Information==
+To display detailed information on a package that is in the repos or installed on your system use the command {{ic|pamac info}}.  Keeping with our example:
+ pamac info smplayer
+If you also would like to check packages in [[Arch_User_Repository|AUR]] you could use:
+ pamac info -a smplayer
+==Updating the System==
+To check if updates are available you can use the command:
+ pamac checkupdates -a
+To update all installed packages installed from the repos or [[Arch_User_Repository|AUR]] you can use the command:
+ pamac upgrade -a
+{{tip|pamac update and pamac upgrade are exactly the same.  You can use them interchangably.}}
+==Other Useful Pamac Functions==
+To check to see if there any orphaned packages(packages which are no longer needed) installed you can use:
+ pamac list -o
+To remove all orphans use the command:
+ pamac remove -o
+To see which package owns a certain file on your system, use the command {{ic|pamac search -f}}.  For example:
+ pamac search -f /usr/bin/smplayer
+To force a package to be installed even if it is already installed use {{ic|pamac reinstall}}.  For example:
+ pamac reinstall smplayer
 [[Category:Contents Page]]
-[[Category:Software Management]]

Pamac (view source)

Revision as of 02:12, 26 May 2019