Development

Banshee’s git source code repository is generously hosted by the GNOME project.

The most current version of the source is called master. It can change minute by minute, and may not be stable at any given point. In fact, it may cause data loss or other bad things. You should only use it if you understand the risk. Otherwise, you should stick with official releases. Read more about using git.

  • Linux Instructions
  • Windows Instructions
  • OS X Instructions

Building on Linux

You need to 1) install dependencies, 2) get the source, and then 3) build it.

1. Install Dependencies

openSUSE 12.1 or higher

On openSUSE 12.1 you’ll need to run the following commands to get all the build dependencies.

sudo zypper in git autoconf automake libtool intltool gcc make
sudo zypper si -d banshee

(Note: in older versions of openSUSE, like 11.0, the package name was “banshee-1”, not “banshee”.)

Ubuntu

On Ubuntu, you’ll need to run the following commands to get all the build dependencies.

sudo apt-get install git-core autoconf automake libtool intltool gcc make libgconf2.0-cil-dev libgconf2-dev
sudo apt-get build-dep banshee
sudo apt-get install libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev
Fedora

On Fedora, you’ll need to run the following commands to get all the build dependencies.

sudo yum install git autoconf automake libtool intltool gcc make
sudo yum-builddep banshee

2. Get Source Code

Check out a copy of Banshee’s git repository:

git clone git://git.gnome.org/banshee
Other Libraries

You don’t need to build and install these from source unless you want to hack on them, or if they are not provided by your distribution.

git clone git://github.com/mono/taglib-sharp.git
git clone git://github.com/mono/gio-sharp.git
git clone git://github.com/mono/gtk-sharp-beans.git
git clone git://github.com/mono/dbus-sharp.git
git clone git://github.com/mono/dbus-sharp-glib.git

For the libgpod-based iPod support:

git clone git://github.com/mono/gudev-sharp.git
git clone git://github.com/mono/gkeyfile-sharp.git
git clone git://gtkpod.git.sourceforge.net/gitroot/gtkpod/libgpod

3. Building, Running, and Installing

Then you should cd banshee (move to the folder where you checked it out from git) and run ./autogen.sh.

If you want to use MonoDevelop, you can open Banshee.sln at this point

To build Banshee from the command line, run make. You can run Banshee from git alongside Banshee from a package by not running make install. Instead launch it with make run.

Building on Windows

Banshee is easy to build on Windows. We consider it to be in alpha, though – it is not stable, well-tested, or polished, so use at your own risk and primarily if you’re trying to help us improve it. Follow these steps to get Banshee building:

  1. Install Dependencies
* .NET 3.5 SP1 or higher
* [msysgit](https://code.google.com/p/msysgit/downloads/detail?name=Git-1.7.4-preview20110204.exe) **with these options**:
  * _"Run Git from the Windows Command Prompt (only adds git to PATH)"_
  * _"Checkout Windows-style, commit Unix-style line endings"_
  * Optionally, install [TortoiseGit](http://code.google.com/p/tortoisegit/) for a GUI git environment
  * Github has a nice [guide for getting started with git](http://github.com/guides/using-git-and-github-for-the-windows-for-newbies) on Windows.
  1. Download and run checkout-banshee.bat
* This script will clone Banshee from git (and a couple submodules).
* You can double click it to run it.  It will check Banshee out into a `banshee` subfolder where the script is located.
  1. Build Banshee
* With your favorite IDE ([MonoDevelop](http://monodevelop.com/) (FOSS, preferred), VisualStudio, SharpDevelop), **open `Banshee.sln`**. Make sure you select the "Windows" configuration.
* Or run the `build\windows\build-banshee.bat` script, which calls `msbuild` directly

Report bugs and file patches according to the normal process.

Building on OS X

It’s quite easy to work on Banshee in Mac OS X. While resulting Banshee releases work on OS X 10.6 (Snow Leopard) and newer, Banshee must be built on OS X 10.7 or newer (Lion).

  1. Install XCode and the Developer Commandline Tools (if your AppStore tells you to upgrade your OSX version to be able to install XCode, you can probably find older versions of XCode in the Apple Developer’s Downloads page).

  2. Launch XCode to see if it works (even if you’re not going to use its UI, you need to make sure that it works ok. Sometimes trying to launch XCode will prompt you to install more tools that are required). Then close it.

  3. Install Git

  4. Build Dependencies

* Takes very long, but only needs to be done infrequently (this process will likely take a few hours; everything from GTK+, to GStreamer, to codecs, to Mono will be built as part of it; when it's finished you'll be left with a full development environment for building and working on Banshee)

      git clone git://github.com/Dynalon/bockbuild.git
      cd bockbuild/profiles/banshee
      ./darwin.py -bvd
  1. Build Banshee
* In the **same parent folder as bockbuild**, run  

      git clone git://git.gnome.org/banshee.git
      cd banshee
      ./bootstrap-bundle
      source darwin.env
      make

You can also use MonoDevelop instead of using make. Open Banshee.sln after the ./bootstrap-bunde step and build with MonoDevelop.

Copyright 2014 Banshee contributors. Banshee is a registered trademark of Novell.