Skip to content
Branch: master
Find file Copy path
Find file Copy path
4 contributors

Users who have contributed to this file

@mcrapet @sheeit @mmagnus @arcresu
118 lines (81 sloc) 3.45 KB
Plowshare installation notes.
Runtime dependencies
To run plowshare you will need:
* GNU/Linux basic operating system: coreutils (chmod, date, ...), sed, util-linux (kill), grep.
Note for BSD/Mac OSX: requires gnu-sed.
* Bash (version 4.1 or better). It will NOT work using Busybox or Dash (POSIX) shell.
* cURL (version 7.24 or better). Compiled with SSL support.
* Character encoding converter (to get proper filenames). This is optional.
- recode or
- perl and HTML::Entities module
* Javascript interpreter. Used by few modules (mostly plowdown).
- spidermonkey or
- rhino (JavaScript engine written in Java)
Some websites are using captchas. If you're not using an automatic solving service,
you'll need a (X11, FB or ascii) picture viewer.
* X11 viewers
- display (imagemagick, X11) or
- sxiv (imlib2, X11, very fast) or
- feh (imlib2, X11) or
- qiv (imlib2, X11)
* Framebuffer viewers
- fbi (frame buffer image viewer) or
- fim (frame buffer and ascii art image viewer)
* Ascii text viewers
- aview (libaa) or
- img2txt (libcaca) or
- tiv (perl script using Image::Magick, color output)
Installation (core)
This is the instructions to install plowshare. Plowshare modules installation is described in the next section.
No compiler is required, it's only Bash scripts!
1) Automatic method: distro packages
This is the easiest method, Plowshare is available for several Linux distribution:
# Archlinux (
$ pacman -Syu plowshare
# Gentoo (
$ emerge -av plowshare
# Debian (
# Note: For Debian 8 "Jessie", the package is called plowshare4. Recent versions are included in jessie-backports.
$ apt-get install plowshare
# Fedora & CentOS (
$ yum install plowshare
Note: You'll probably need to be root to install the plowshare package.
# Mac OS X (with Homebrew)
$ brew install plowshare
2) Manual method: from git sources
$ git clone
# If you have root privileges (like Ubuntu)
$ sudo make install
# For non root users, you can override default prefix (/usr)
# (make sure you have $HOME/local/bin in you PATH)
$ make install PREFIX=$HOME/local
Note for FreeBSD users
You must manually install from sources.
You'll need GNU make (not bmake) and gnu-sed (or gsed) installed.
Don't forget to properly define GNU_SED variable.
# For example
$ make install patch_gnused GNU_SED=/opt/bin/gnu-sed PREFIX=/usr
Advanced users and maintainers
# If you are on a cross-compilation environment:
# (default prefix is /usr)
$ make install DESTDIR=/media/rootfs
$ make install PREFIX=/opt DESTDIR=/media/rootfs
Installation (external modules)
1) Automatic method: using plowmod
$ plowmod --install
plowmod is a simple tool for managing your modules directory (~/.config/plowshare/modules.d).
If git (>1.8.5) is installed on your system, you can use later:
$ plowmod --update
Plowmod can handle 3rd part repositories. See man page for more information.
2) Manual method: from sources
$ mkdir -p ~/.config/plowshare/modules.d
$ cd ~/.config/plowshare/modules.d
$ curl -L -k | tar zxf -
$ mv plowshare-modules-legacy-master legacy
# vim:fileencoding=utf-8
You can’t perform that action at this time.