/apt-fast

apt-fast: A shellscript wrapper for apt that speeds up downloading of packages.
  1. Shell 94.6%
  2. Makefile 5.4%
Shell Makefile
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP
Find file
Switch branches/tags
Nothing to show
Latest commit b2362d1 Jan 6, 2018 @Lasall Lasall Consistently use msg() for output. 
 * Use msg function for all terminal output, so an ${aptfast_prefix} can be
   properly applied.
 * Remove leading whitespace from some existing output messages. Set prefix
   appropriately.
 * Apply prefix also to download command (with sed). This has the disadvantage
   to fail on interactive (custom) download commands. Some documentation or
   switch to disable this "functionality" might be recommended.
   This is also one reason why the prefix is not applied to the package
   manager.
 * Reword download confirmation to a be shorter and more meaningful, similar
   to apt-get's confirmation.
 * Don't use tput for line manipulation when not in a terminal.
   Note: The usage of tput requires some additional program logic, which might
         not be justified.

 * Fixes issue when no files are to download. (Some code was still reached
   that failed to process the empty data.)
Permalink
Failed to load latest commit information.
completions Fix completions (#122) Oct 29, 2017
man Download size and formatted package listing. Closes #84 and closes #134 Jan 5, 2018
Makefile install to /usr/local hierarchy (Closes #108) (#124) Oct 30, 2017
README.md Download size and formatted package listing. Closes #84 and closes #134 Jan 5, 2018
apt-fast Consistently use msg() for output. Jan 6, 2018
apt-fast.conf Remove space before default options. Nov 1, 2017
quick-install.sh quick-install.sh improvements, closes #112 Nov 20, 2017

README.md

apt-fast 1.8

apt-fast is a shellscript wrapper for apt-get and aptitude that can drastically improve apt download times by downloading packages in parallel, with multiple connections per package.

Table of Contents

Installation

sudo add-apt-repository ppa:apt-fast/stable
sudo apt-get update
sudo apt-get -y install apt-fast

Ubuntu PPA

You can use the Ubuntu PPA to get a graphical configuration file setup and automatic updates, for details see:

Some distros, such as PCLinuxOS include apt-fast in their repos.

Quick Install

You can quickly install apt-fast by running:

/bin/bash -c "$(curl -sL https://git.io/vokNn)"

Manual

A manual install can be performed as such:

cp apt-fast /usr/local/sbin/
chmod +x /usr/local/sbin/apt-fast
cp apt-fast.conf /etc

You need to have aria2c installed:

apt-get install aria2

Then simply run apt-fast instead of apt-get or aptitude.

Autocompletion

Bash

cp completions/bash/apt-fast /etc/bash_completion.d/
chown root:root /etc/bash_completion.d/apt-fast
. /etc/bash_completion

Zsh

cp completions/zsh/_apt-fast /usr/share/zsh/functions/Completion/Debian/
chown root:root /usr/share/zsh/functions/Completion/Debian/_apt-fast
source /usr/share/zsh/functions/Completion/Debian/_apt-fast

Man page installation

mkdir -p /usr/local/share/man/man8/
cp ./man/apt-fast.8 /usr/local/share/man/man8
gzip -f9 /usr/local/share/man/man8/apt-fast.8
mkdir -p /usr/local/share/man/man5/
cp ./man/apt-fast.conf.5 /usr/local/share/man/man5
gzip -f9 /usr/local/share/man/man5/apt-fast.conf.5

Configuration

The apt-fast configuration file is located at: /etc/apt-fast.conf

Package manager

_APTMGR=apt-get

Change package manager used for installation. Supported are apt-get, aptitude, apt.

Confirmation dialog

DOWNLOADBEFORE=true

To suppress apt-fast confirmation dialog and download packages directly set this to any value. To ask for confirmation, leave empty. This options doesn't affect package manager confirmation.

Multiple mirrors

Adding multiple mirrors will further speed up downloads and distribute load, be sure to add mirrors near to your location. Official mirror lists:

Then add them to whitespace and comma separated list in config file, e.g.:

MIRRORS=( 'http://ftp.debian.org/debian, http://ftp2.de.debian.org/debian, http://ftp.de.debian.org/debian, ftp://ftp.uni-kl.de/debian' )
MIRRORS=( 'http://archive.ubuntu.com/ubuntu, http://de.archive.ubuntu.com/ubuntu, http://ftp.halifax.rwth-aachen.de/ubuntu, http://ftp.uni-kl.de/pub/linux/ubuntu, http://mirror.informatik.uni-mannheim.de/pub/linux/distributions/ubuntu/' )

NOTE: To use any mirrors you may have in sources.list or sources.list.d you will need to add them to the apt-fast.conf mirror list.

Maximum connections

_MAXNUM=5

Set to maximum number of connections aria2c uses.

Maximum connections per server

_MAXCONPERSRV=10

Set to maximum number of connections per server aria2c uses.

Maximum connections per file

_SPLITCON=8

Set to maximum number of connections per file aria2c uses.

File split size

_MINSPLITSZ=1M

Set to size of each split piece. Possible values: 1M-1024M

Piece selection algorithm

_PIECEALGO=default

Set to piece selection algorithm to use. Possible values: default, inorder, geom

Downloadmanager file

DLLIST='/tmp/apt-fast.list'

Location of aria2c input file, used to download the packages with options and checksums.

Downloadmanager command

_DOWNLOADER='aria2c --no-conf -c -j ${_MAXNUM} -x ${_MAXCONPERSRV} -s ${_SPLITCON} -i ${DLLIST} --min-split-size=${_MINSPLITSZ} --stream-piece-selector=${_PIECEALGO} --connect-timeout=600 --timeout=600 -m0'

Change the download manager or add additional options to aria2c.

Proxy

_DOWNLOADER='aria2c --no-conf -c -j ${_MAXNUM} -x ${_MAXCONPERSRV} -s ${_SPLITCON} --min-split-size=${_MINSPLITSZ} --stream-piece-selector=${_PIECEALGO} --http-proxy=http://username:password@proxy_ip:proxy_port -i ${DLLIST}'

To use apt-fast behind a proxy, use --http-proxy option of aria2c and set username, password and proxy_port accordingly.

Download folder

DLDIR='/var/cache/apt/archives/apt-fast'

Directory where apt-fast downloads the packages.

APT archives cache

APTCACHE='/var/cache/apt/archives'

Directory where apt-get and aptitude download packages.

Verbose output

VERBOSE_OUTPUT=y

Show aria2 download file instead of package listing before download confirmation. Unset to show package listing.

Colors

cGreen='\e[0;32m'
cRed='\e[0;31m'
cBlue='\e[0;34m'
endColor='\e[0m'

Terminal colors used for dialogs. Refer to ANSI Escape sequences for a list of possible values. Disabled when not using terminal.

License

Consider apt-fast and all of its derivatives licensed under the GNU GPLv3+.

Copyright: 2008-2012 Matt Parnell, http://www.mattparnell.com Improvements, maintenance, revisions - 2012 Dominique Lasserre

Special thanks

  • Travis/travisn000 - support for complex apt-get commands
  • Alan Hoffmeister - aria2c support
  • Abhishek Sharma - aria2c with proxy support
  • Luca Marchetti - improvements on the locking system and downloader execution
  • Richard Klien - Autocompletion, Download Size Checking (made for on ubuntu, untested on other distros)
  • Patrick Kramer Ruiz - suggestions
  • Sergio Silva - test to see if axel is installed, root detection/sudo autorun, lock file check/creation
  • Waldemar {BOB}{Burnfaker} Wetzel - lockfile improvements, separate config file
  • maclarke - locking improvements