From 92ac787315f2c157372009b30006d7fedda6cbc3 Mon Sep 17 00:00:00 2001 From: Jeff George Date: Tue, 16 Aug 2011 16:17:27 -0400 Subject: [PATCH] Kill .bzr stuff, add .gitignore & a pretty README.md for GitHub. --- .bzreol | 15 --------------- .bzrignore | 10 ---------- .bzrtab | 13 ------------- .gitignore | 27 +++++++++++++++++++++++++++ README.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 81 insertions(+), 38 deletions(-) delete mode 100644 .bzreol delete mode 100644 .bzrignore delete mode 100644 .bzrtab create mode 100644 .gitignore create mode 100644 README.md diff --git a/.bzreol b/.bzreol deleted file mode 100644 index c9d91d2..0000000 --- a/.bzreol +++ /dev/null @@ -1,15 +0,0 @@ -[LF] -.bzreol -.bzrignore -*.py -*.tmpl -*.js -*.css -*.txt -*.po -*.pot -*.sh -[CRLF] -*.bat -*.cmd -*.nsi diff --git a/.bzrignore b/.bzrignore deleted file mode 100644 index 6b1b969..0000000 --- a/.bzrignore +++ /dev/null @@ -1,10 +0,0 @@ -*.pyc -*.pyo -build -dist -locale -srcdist -cherrypy -*.wpr -*.keep -*.bak diff --git a/.bzrtab b/.bzrtab deleted file mode 100644 index 9d85101..0000000 --- a/.bzrtab +++ /dev/null @@ -1,13 +0,0 @@ -[NOTAB] -*.py -*.txt -*.po -*.pot -*.sh -*.bat -*.cmd -*.nsi -*.tmpl -*.js -*.css -[TAB] diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..6bc5eee --- /dev/null +++ b/.gitignore @@ -0,0 +1,27 @@ +#Compiled python +*.py[co] + +# Working folders for Win build +build/ +dist/ +locale/ +srcdist/ + +# Generated email templates +email/ + +# Romanian ro.po is generated from ro.px, due to mapping to latin-1 +po/*/ro.po + +# Build results +SABnzbd*.zip +SABnzbd*.exe +SABnzbd*.gz + +# WingIDE project file +*.wpr + +# General junk +*.keep +*.bak +*.log diff --git a/README.md b/README.md new file mode 100644 index 0000000..0d00c28 --- /dev/null +++ b/README.md @@ -0,0 +1,54 @@ +SABnzbd - The automated Usenet download tool +============================================ + +SABnzbd is an Open Source Binary Newsreader written in Python. + +It's totally free, incredibly easy to use, and works practically everywhere. + +SABnzbd makes Usenet as simple and streamlined as possible by automating everything we can. All you have to do is add an .nzb. SABnzbd takes over from there, where it will be automatically downloaded, verified, repaired, extracted and filed away with zero human interaction. + +If you want to know more you can head over to our website: http://sabnzbd.org. + +## Resolving Dependencies + +SABnzbd has a good deal of dependencies you'll need before you can get running. If you've previously run SABnzbd from one of the various Linux packages floating around (Ubuntu, Debian, Fedora, etc), then you likely already have all the needed dependencies. If not, here's what you're looking for: + +- `python` (We support Python 2.5-2.7, preferably 2.6 or 2.7.) +- `python-cheetah` +- `python-configobj` +- `python-feedparser` +- `python-dbus` +- `python-openssl` +- `python-support` +- `python-yenc` +- `par2` (Multi-threaded par2 can be downloaded from [ChuChuSoft](http://chuchusoft.com/par2_tbb/download.html) ) +- `unrar` (Make sure you get the "official" non-free version of unrar) +- `unzip` + +Your package manager should supply these. If not, we've got links in our more in-depth [installation guide](https://github.com/sabnzbd/sabnzbd/blob/master/INSTALL.txt). + +## Running SABnzbd from source + +Once you've sorted out all the dependencies, simply run: + +``` +python SABnzbd.py +``` + +Or, if you want to run in the background: + +``` +python -d -f /path/to/sabnzbd.ini +``` + +If you want multi-language support, run: + +``` +python tools/make_mo.py +``` + +Our many other commandline options are explained in depth [here](http://wiki.sabnzbd.org/command-line-parameters). + +## About Our Repo + +We're going to be attempting to follow the [gitflow model](http://nvie.com/posts/a-successful-git-branching-model/), so you can consider "master" to be whatever our present stable release build is (presently 0.6.x) and "develop" to be whatever our next build will be (presently 0.7.x). Once we transition from unstable to stable dev builds we'll create release branches, and encourage you to follow along and help us test. \ No newline at end of file