{"id":14235873,"url":"https://github.com/rmarquis/pacaur","last_synced_at":"2025-08-11T00:33:09.116Z","repository":{"id":1506870,"uuid":"1762912","full_name":"rmarquis/pacaur","owner":"rmarquis","description":"[unmaintained] An AUR helper that minimizes user interaction","archived":true,"fork":false,"pushed_at":"2018-05-30T14:18:28.000Z","size":2010,"stargazers_count":796,"open_issues_count":28,"forks_count":113,"subscribers_count":27,"default_branch":"master","last_synced_at":"2024-08-21T21:27:52.763Z","etag":null,"topics":["arch","archlinux","aur","aur-helper","helper","pacaur","pacman","shell"],"latest_commit_sha":null,"homepage":"https://bbs.archlinux.org/viewtopic.php?pid=1755144#p1755144","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rmarquis.png","metadata":{"files":{"readme":"README.pod","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-05-17T21:02:25.000Z","updated_at":"2024-04-01T17:44:03.000Z","dependencies_parsed_at":"2022-08-16T13:30:59.069Z","dependency_job_id":null,"html_url":"https://github.com/rmarquis/pacaur","commit_stats":null,"previous_names":[],"tags_count":205,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rmarquis%2Fpacaur","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rmarquis%2Fpacaur/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rmarquis%2Fpacaur/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rmarquis%2Fpacaur/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rmarquis","download_url":"https://codeload.github.com/rmarquis/pacaur/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229478742,"owners_count":18079376,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arch","archlinux","aur","aur-helper","helper","pacaur","pacman","shell"],"created_at":"2024-08-20T21:02:27.018Z","updated_at":"2024-12-13T01:30:51.747Z","avatar_url":"https://github.com/rmarquis.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"=encoding utf8\n\n=head1 NAME\n\npacaur - an AUR helper that minimizes user interaction\n\n=head1 SYNOPSIS\n\nUsage: I\u003cpacaur\u003e E\u003clt\u003eoperationE\u003cgt\u003e [ options ] [ target(s) ]\n\n=head1 DESCRIPTION\n\nPacaur is an Arch User Repository (AUR) helper aiming at speed and simplicity\nand is designed to minimize user prompt interaction. It uses an uncluttered\ninterface and makes use of the full secured RPC interface to solve the dependency\ntree. It will also automatically prompt for sudo access when needed. It is built\nupon the well designed cower and expac C backends.\n\nInvoking pacaur consists of supplying an operation, any applicable options, and\nusually one or more targets. A I\u003ctarget\u003e is usually a package name or a search\nstring.\n\n=head1 USERBASE TARGET\n\nPacaur is targeted at B\u003cadvanced users\u003e who want some degree of automation for\nrepetitive tasks. As such, the user is expected to be familiar with the AUR\nmanual build process with makepkg and its configuration options, as well as\nbeing knowledgeable about sudo and gpg configuration.\n\nTwo sets of command line options are provided: commands which call the pacman\nbinary and extend it with AUR functions B\u003c(-S, -Ss, -Si, -Sw, -Su, -Qu, -Sc, -Scc)\u003e,\nand commands which are AUR specific B\u003c(sync, search, info, buildonly,\nupgrade, check, clean, cleanall)\u003e. As such, pacaur can be used by users\nwho prefer to have a single tool to manage the official and AUR repositories, or\nby users who prefer to keep their AUR frontend separated from pacman.\n\n=head1 OPERATIONS\n\n=head2 Pacman extension operations\n\n=over 4\n\n=item B\u003c-S, -Ss, -Si, -Sw, -Su, -Qu, -Sc, -Scc\u003e\n\nPacaur wraps all B\u003cpacman operations\u003e and by default extends respectively its\nsync, search, info, download only, system upgrade, upgrades check, clean and\nclean all functions to the AUR. This extension behavior is optional and can be\ndisabled with the I\u003cfallback\u003e variable in the config file. Pacaur will also pass\nany other pacman operations and their related options to the pacman binary.\n\n=back\n\n=head2 AUR specific operations\n\n=over 4\n\n=item B\u003csync\u003e\n\nClone build files, build and install I\u003ctarget(s)\u003e. Missing dependencies will be\nautomatically installed as needed.\n\n=item B\u003csearch\u003e\n\nSearch for packages with the I\u003ctarget(s)\u003e as the search term(s). Queries with\nmultiple targets will return the result of the intersection of all query\nresults. Extended regex patterns as defined by POSIX are allowed.\nThe output will display the name, version, votes and popularity values of each\npackage. The flagged status will also be indicated by a \u003c!\u003e symbol or a colored\nversion string if colored output is enabled.\n\n=item B\u003cinfo\u003e\n\nShow info for I\u003ctarget(s)\u003e.\n\n=item B\u003cbuildonly\u003e\n\nClone build files and build I\u003ctarget(s)\u003e. Missing dependencies will be installed\nas needed for the build process, and removed automatically afterwards.\n\n=item B\u003cupgrade\u003e\n\nUpdate foreign packages in the AUR. Without any arguments, all manually\ninstalled packages will be upgraded. If I\u003ctarget(s)\u003e are supplied, only those\npackages will be upgraded.\n\n=item B\u003ccheck\u003e\n\nCheck foreign packages for upgrades in the AUR. Without any arguments, all\nmanually installed packages will be checked. If I\u003ctarget(s)\u003e are supplied, only\nthose packages will be checked.\n\n=item B\u003cclean\u003e\n\nClean foreign packages and clones. Offer to remove all non locally installed\nbuilt packages from defined I\u003cPKGDEST\u003e cache, all non development files from\ndefined I\u003cSRCDEST\u003e cache, and all uninstalled clones from AUR clones directory.\nIf I\u003ctarget(s)\u003e are supplied, only those specific clones will be removed.\n\n=item B\u003ccleanall\u003e\n\nClean all foreign packages and clones. Offer to remove all built packages from\ndefined I\u003cPKGDEST\u003e, all sources in defined I\u003cSRCDEST\u003e, and all local clones from\nclones directory.\n\n=back\n\n=head2 General operations\n\n=over 4\n\n=item B\u003c-v, --version\u003e\n\nDisplay version and quit.\n\n=item B\u003c-h, --help\u003e\n\nDisplay the help message and quit.\n\n=back\n\n=head1 OPTIONS\n\n=head2 Pacman extension options\n\n=over 4\n\n=item B\u003c-a, --aur\u003e\n\nWhen used with pacman extended operations, only search, build, install, upgrade\nor clean I\u003ctarget(s)\u003e from the AUR. When combined with I\u003c-Syu\u003e, only the I\u003c-Sy\u003e\noperation is run for the repositories.\n\n=item B\u003c-r, --repo\u003e\n\nWhen used with pacman extended operations, only search, build, install, upgrade\nor clean I\u003ctarget(s)\u003e from the repositories.\n\n=back\n\n=head2 General options\n\n=over 4\n\n=item B\u003c-e, --edit\u003e\n\nEdit build files when cloning or building I\u003ctarget(s)\u003e. Overrides the\nI\u003cdisplaybuildfiles\u003e config option and always fully shows the build files.\nCan also be used as a standalone command.\n\n=item B\u003c-q, --quiet\u003e\n\nShow less information for search and query operations. Search will only show\npackage names and not version, group, and description information.\n\n=item B\u003c--devel\u003e\n\nWhen used with upgrade and check operations, also consider AUR development\npackages. Supported are I\u003ccvs\u003e, I\u003csvn\u003e, I\u003cgit\u003e, I\u003chg\u003e, I\u003cbzr\u003e and I\u003cdarcs\u003e\ndevelopment packages, as well as I\u003cdaily\u003e and I\u003cnightly\u003e build packages.\n\n=item B\u003c--foreign\u003e\n\nWhen used with buildonly, sync and upgrade operations, also consider already\ninstalled foreign dependencies when solving the dependency tree.\n\n=item B\u003c--ignore\u003e I\u003ctarget(s)\u003e\n\nIgnore a I\u003ctarget\u003e upgrade. Can be used more than once. Also accepts a comma\ndelimited list as a single argument. Packages listed in pacman and cower's\nI\u003cIgnorePkg\u003e directive are honored.\n\n=item B\u003c--needed\u003e\n\nDo not reinstall I\u003ctarget(s)\u003e that are already up-to-date. The build of\ndevelopment packages that are found up-to-date after the source checkout will\nbe skipped. Supported are I\u003csvn\u003e, I\u003cgit\u003e, I\u003chg\u003e and I\u003cbzr\u003e development\npackages, as well as I\u003cdaily\u003e and I\u003cnightly\u003e build packages.\n\n=item B\u003c--noconfirm\u003e\n\nPerform commands without confirmation from the user.\n\n=item B\u003c--noedit\u003e\n\nPerform commands without editing any installation files. Overrides the\nI\u003c--edit\u003e option.\n\n=item B\u003c--rebuild\u003e\n\nAlways rebuild packages regardless of any existing file in I\u003c$PKGDEST\u003e directory,\nand regardless of up-to-date status of development packages.\n\n=item B\u003c--silent\u003e\n\nSilence output. This will send the output of each packaging functions to text\nfiles in the clone directory named I\u003cpkgname-pkgver-pkgrel-arch-function.log\u003e.\nAdditional pacman output for providers and cached packages installation will\nalso be hidden.\n\n=back\n\n=head2 Search options\n\n=over 4\n\n=item B\u003c--by\u003e \u003cFIELD\u003e\n\nWhen searching the AUR, search by I\u003cFIELD\u003e where I\u003cFIELD\u003e is B\u003cname\u003e, B\u003cname-desc\u003e,\nor B\u003cmaintainer\u003e to search for packages by their name, name and description, or by\nthe package maintainer, respectively. The default is to search by name-desc.\n\n=item B\u003c--ignore-ood\u003e, B\u003c--no-ignore-ood\u003e\n\nWhen searching the AUR, ignore all results marked as out of date or do not ignore\nresults marked as out of date, respectively. The default is to not ignore results\nmarked as out of date. This can be changed with the I\u003cIgnoreOOD\u003e option in the\ncower config file.\n\n=item B\u003c--literal\u003e\n\nWhen searching the AUR, disable regex search and interpret target as a literal\nstring.\n\n=item B\u003c--sort\u003e \u003cKEY\u003e, B\u003c--rsort\u003e \u003cKEY\u003e\n\nWhen searching the AUR, sort the results in ascending or descending order,\nrespectively, by I\u003cKEY\u003e where I\u003cKEY\u003e is B\u003cname\u003e, B\u003cvotes\u003e or B\u003cpopularity\u003e.\n\n=back\n\n=head2 Other options\n\n=over 4\n\n=item B\u003c--domain\u003e \u003cFQDN\u003e\n\nPoint at a domain other than the default I\u003caur.archlinux.org\u003e.\n\n=back\n\n=head1 CONFIG FILE\n\n=over 4\n\n=item B\u003csystem config\u003e\n\nPacaur honors a system-wide config file which will be looked for first at\n\n  $XDG_CONFIG_DIRS/pacaur/config\n\nand falling back to\n\n  /etc/xdg/pacaur/config\n\n=item B\u003cuser config\u003e\n\nUser-defined configuration files overriding the general settings will be looked\nfor first at\n\n  $XDG_CONFIG_HOME/pacaur/config\n\nand falling back to\n\n  $HOME/.config/pacaur/config\n\n=item B\u003cother config\u003e\n\nIn addition, pacaur fully honors cower's config file. See B\u003ccower\u003e(1).\n\n=back\n\n=head1 CONFIG OPTIONS\n\nThe available options are:\n\n=over 4\n\n=item B\u003ceditor\u003e\n\nDefine the editor. Default is B\u003c$VISUAL\u003e, with a fallback on B\u003c$EDITOR\u003e and I\u003cnano\u003e.\n\n=item B\u003cdisplaybuildfiles\u003e\n\nDisplay PKGBUILD and install script viewing prompt. Possible values are I\u003cfull\u003e\nto always display the full build files, I\u003cdiff\u003e to only display the difference\nsince last build, and I\u003cnone\u003e to disable the viewing prompt. Default is B\u003cdiff\u003e.\n\n=item B\u003cfallback\u003e\n\nExtend pacman commands to the AUR. Default is B\u003ctrue\u003e.\n\n=item B\u003csilent\u003e\n\nEnable silent output. The makepkg output will be collected in the clone directory\nor the I\u003c$LOGDEST\u003e directory should any error occur. Default is B\u003cfalse\u003e.\n\n=item B\u003csortby\u003e\n\nWhen searching the AUR, sort the results by I\u003cname\u003e, number of I\u003cvotes\u003e or\nI\u003cpopularity\u003e. Default is B\u003cpopularity\u003e.\n\n=item B\u003csortorder\u003e\n\nWhen searching the AUR, sort the results in I\u003cascending\u003e or I\u003cdescending\u003e order.\nDefault is B\u003cdescending\u003e.\n\n=item B\u003csudoloop\u003e\n\nPrevent sudo timeout. This option overrides the system-wide I\u003cpasswd_timeout\u003e\nsudo configuration and refreshes the sudo timestamp automatically in a loop when\nbuilding packages. Default is B\u003ctrue\u003e.\n\n=back\n\n=head1 ENVIRONMENT\n\n=over 4\n\n=item B\u003cAURDEST\u003e\n\nDetermines where the packages build files (PKGBUILD, .SRCINFO and install script\nfiles) will be cloned. The I\u003c-Sc\u003e and I\u003c-Scc\u003e clean operations allow to remove\nthe untracked cloned files and the non locally installed cloned files, and all\ncloned files, respectively.\n\nIf this environment variable is not defined, the clone directory will be set to\n\n  $XDG_CACHE_HOME/pacaur\n\nwith a fall back to\n\n  $HOME/.cache/pacaur\n\n=back\n\nIn addition, makepkg environment variables are fully honored. See B\u003cmakepkg\u003e(8).\nIn particular, the following variables are useful:\n\n=over 4\n\n=item B\u003cPKGDEST\u003e\n\nDetermines where the built packages will be stored. If using the existing\nI\u003c/var/cache/pacman/pkg\u003e pacman cache directory, ensure your user has proper\nwrite permissions. Additionally, if added to the I\u003cCacheDir\u003e path option of\nI\u003cpacman.conf\u003e, the I\u003c-Sc\u003e and I\u003c-Scc\u003e clean operations will enable removal of\nnon locally installed cached files and all cached files, respectively.\n\n=item B\u003cSRCDEST\u003e\n\nDetermines where the source of packages will be stored. This will speed up the\nupgrade of development packages. The I\u003c-Sc\u003e and I\u003c-Scc\u003e clean operations allow\nto remove the non development packages source files and all source files,\nrespectively.\n\n=item B\u003cLOGDEST\u003e\n\nDetermines where the build logs will be stored. By default, the I\u003c--silent\u003e\noption will write build logs in the clone directory if the build fails, but\nwill remove them if the build succeeds.\n\n=item B\u003cBUILDDIR\u003e\n\nDetermines where the packages will be built. By default, build will happen in\nthe defined clone directory, but build speed can be improved by using I\u003c/tmp\u003e\nlocated in volatile memory. This is however not recommended if big packages\nneed to be built on a low-memory machine.\n\n=back\n\n=head1 NOTES\n\n=over 4\n\n=item B\u003csudo configuration\u003e\n\nTo be used with minimal password prompting, I\u003csudo\u003e should be configured\naccordingly to allow sudo access. See B\u003csudoers\u003e(5). If you disable the\nI\u003csudoloop\u003e config option, you might also want to disable the I\u003cpasswd_timeout\u003e\nsudo parameter to avoid password prompt timeout.\n\n=item B\u003cpacman misc options\u003e\n\nMiscellaneous options enabled in I\u003cpacman.conf\u003e are taken into account. Thus,\ncolored output can be enabled with the I\u003cColor\u003e option, while a detailed interface\ndisplaying name, version and size of packages formatted as a table is available\nthrough the I\u003cVerbosePkgLists\u003e option.\n\n=item B\u003cbuild files comparison\u003e\n\nTo allow build files comparison, the I\u003cdisplaybuildfiles\u003e default config option\nis set to I\u003cdiff\u003e. Although the clone directory (set by default to\nI\u003c$XDG_CACHE_HOME/pacaur\u003e) can be changed through the alternative I\u003c$AURDEST\u003e\nenvironment variable, it should always be set to a persistent location.\n\n=item B\u003cfallback\u003e\n\nBy default, any operation will be applied on the binary repositories, then the\nAUR if necessary. This behavior is optional and can be disabled with the\nI\u003cfallback\u003e config option. When disabled, any operation will be restricted to\nthe binary repositories similarly to pacman, while AUR operations can be\napplied explicitly with the I\u003c--aur\u003e option.\n\n=item B\u003cinteractive PKGBUILDs\u003e\n\nPackages requiring user input while building are not supported and might fail\nto install properly. There is currently no official directive about these\ninteractive PKGBUILDs, but some of the official pacman developers expressed\nthe opinion that PKGBUILDs should always provide default compilation options.\n\n=item B\u003chost name error\u003e\n\nIf a lot of \"Could not connect to the AUR\" and \"Timeout was reached\" messages\nare displayed while searching or requesting info for packages despite the\ninternet connection working correctly, ensure your local I\u003cDNS server\u003e is\ncorrectly configured to improve name lookups. Using Google's primary DNS\n(8.8.8.8 and 8.8.4.4) might also help.\n\n=back\n\n=head1 SEE ALSO\n\nB\u003ccower\u003e(1), B\u003cpacman\u003e(8), B\u003cmakepkg\u003e(8), B\u003csudoers\u003e(5)\n\n=head1 AUTHOR\n\nRemy Marquis E\u003clt\u003eremy.marquis@gmail.comE\u003cgt\u003e\n\nIf you feel great pity for the present maintainer that has to constantly cope\nwith users that don't want to read man pages and refuse to take responsibility\nfor their own system, you can send me funny cat pictures. Alternatively, you\ncan send a donation via PayPal to the above email address.\n\nI would also suggest to donate to a charitable organization of your choice\nshould you believe that your money could make a bigger difference there.\nThank you!\n\nAbsolutely B\u003cno support\u003e is provided, unless you are ready to pay for it.\n\nAll credits go to all direct or indirect contributors. Many thanks to all of\nyou!\n\n=head1 TRANSLATORS\n\nB\u003c[ca] - Català\u003e - Alex \"alexhenrie\" Henrie\n\nB\u003c[da] - Dansk\u003e - Filip \"filipkemuel\" Kemuel\n\nB\u003c[de] - Deutsch\u003e - Marco \"BigBoot\" Kirchner, \"HerrNieschnell\", \"pszalanski\", Stefan \"rumpelsepp\" Tatschner, Tilman \"Tblue\" Blumenbach\n\nB\u003c[es] - Español\u003e - Germán \"gosella\" Osella Massa, Ismael \"ChuckDaniels87\" González, Pablo \"jristz\" Lezaeta Reyes\n\nB\u003c[fi] - Suomi\u003e - \"durazell\"\n\nB\u003c[fr] - Français\u003e - \"spider-mario\", \"Neitsab\", Antoine \"Nevax07\" Gravelot\n\nB\u003c[hu] - Magyar\u003e - \"avelkei\"\n\nB\u003c[it] - Italiano\u003e - Demenico \"NoMore201\" Lezzi, Giovanni \"ItachiSan\" Santini\n\nB\u003c[ja] - 日本語\u003e - Colin \"fosskers\" Woodbury, TSUYUSATO \"MakeNowJust\" Kitsune\n\nB\u003c[nl] - Nederlands\u003e - \"Yoshi2889\", Willem \"14mRh4X0r\" Mulder\n\nB\u003c[pl] - Polski\u003e - Tomasz \"Ludvick\" Niedzielski\n\nB\u003c[pt] - Português\u003e - Thiago \"thiagowfx\" Barroso Perrotta, Rafael \"rccavalcanti\" Cavalcanti\n\nB\u003c[ru] - Русский\u003e - \"kyak\"\n\nB\u003c[sk] - Slovenčina\u003e - Pavol \"pakapusta\" Kapusta, Juraj \"DoctorJellyface\" Fiala\n\nB\u003c[sl] - Slovenščina\u003e - Žan \"tofiffe\" Skamljič\n\nB\u003c[sr] - Српски / srpski\u003e - Slobodan \"Faenriis\" Terzić\n\nB\u003c[tr] - Türkçe\u003e - Volkan \"wakeup\" Gezer\n\nB\u003c[zh_CN] - 简体中文\u003e - \"Victorique \"victoriqueko\" Ko, kizayoi\"\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frmarquis%2Fpacaur","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frmarquis%2Fpacaur","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frmarquis%2Fpacaur/lists"}