Go to file
daviddarts 1b1afa556b Update motd.txt
Edited and updated the MOTD.
2015-01-16 20:54:42 +04:00
BuildScripts Added packaing-folder 2013-02-26 20:58:57 +01:00
image_stuff first collection of files 2012-04-14 16:22:27 +02:00
piratebox Update motd.txt 2015-01-16 20:54:42 +04:00
.gitignore fixing merge issue 2013-04-09 08:02:00 +02:00
AUTHORS Added Authors file 2012-05-08 21:10:59 +02:00
Makefile first implementation of IRC Server miniircd 2013-04-09 08:02:05 +02:00
README added IRC Server to Feature list 2013-04-09 08:02:05 +02:00

README

# PirateBoxScripts with Modifications for running in a Webserver
#  (c) 2013 Matthias Strubel   licenced under GPL-3
#           matthias.strubel@aod-rpg.de
#
#  Maintained by Matthias Strubel
#  	    	 	matthias.strubel@aod-rpg.de
# 		 Cale Black
# 		 	cablack@rams.colostate.edu
# 
# Sources for Running PirateBox with Webserver lighttpd 
#    Contains:  Shoutbox, Forum
#
#                
PirateBox is a collection of scripts / programs that allows you to use your wireless card
as a local network to share files and chat anonymously. For more information please visit
http://daviddarts.com/

----- Info -----
Packages contains only scripts based PirateBox scripts with running lighttpd webserver.

PirateBox scripts can:
   * Setup WLAN Interface via iw
   * Setup hotspot functionality (hostapd)
   * Setup IP Adresses of wlan interface
   * Can add wlan interface to an existing bridge
   * Sets Up a DHCP Server with redirect to wlan-interface IP
   * Upload landing page  (via iframe droopy)
   * Browse Uploaded files
   * Announce "Internet yes" for iOS
   * Announce "Internet yes" for MS devices
   * ShoutBox
   * Optional small python Forum
   * Optional imageboard
   * Optional Station counter
   * Optional Inihibit starting upload-script
   * Optional Timesave script (for devices without RTC)  - can be found in piratebox/bin/timesave.sh 
   * Optional Poll for WLAN device until it available (for USB wifi cards)
   * Optional IRC-Server


Is supported by mkPirateBox > v0.5 for OpenWRT Systems https://github.com/MaStr/mkPirateBox
and by PirateBox Manager https://github.com/TerrorByte/PirateBox-Manager

----- Installation -----
PirateBox should be in most common repositories soon, but in the mean time you can use this method:


##### For alpha testing

Download the package:
https://github.com/MaStr/PirateBoxScripts_Webserver/archive/master.zip

Unzip the package:
$unzip master.zip

Run the installer in the unzipped folder:
$ cd PirateBoxScripts_Webserver/piratebox
$ sudo ./install.sh default #Default can be substituted with 'board' if you want an image board on your PB

Starting / Stopping PirateBox
WARNING: Some major distributions have changed from init.d to systemd which means you should use the 
commands that are labeled under your distribution or what your distribution is based on. It should 
also be noted that as of recently Ubuntu has systemd enabled but not set as the default init system
which means that you may have to use the systemctl commands.

Newest versions of Ubuntu, Fedora, Arch, OpenSUSE, Mageia, and Mandriva:
$ systemctl start piratebox
$ systemctl start piratebox
$ systemctl restart piratebox

Older Ubuntu (xubuntu, lubuntu, etc), Mint, Debian, most Debian based distros: 
$ service piratebox start
$ service piratebox stop
$ service piratebox restart

----- Changelog -----
Version: 0.7a
NOTE: This may only be a partial changelog, check github / your package manager for more info.

* [New] push of systemd structure
* [New] install method
	* [New] install dependencies
* [New] can now use restart in init
* [Fixed] General cleaning
* [Removed] [Testing] Executable, we will stick to service based