====== Welcome to the Mixxx Wiki! ======

Mixxx has an unusually broad community for an open-source project, encompassing performing musicians, C++ addicts, amateur DJs and even just casual users. The Mixxx Wiki contains useful information for users, developers, and artists, and is summarized in the categories below.

Most of the contents of this wiki can be edited by anyone, the main exception to this is the [[development_roadmap]] which is a fairly authoritative description of the development team's plans.

**Mixxx is participating in Google Summer of Code 2010: ** See [[start#google_summer_of_code|below]] for more info.

===== User Documentation =====
  ***[[Getting Involved|Getting Involved in Mixxx]]** <- Help us make Mixxx better, find out what you can do.
  *[[Beginner's Guide]]
  *[[Manual]]
  *[[Hercules|Hercules DJ Series Input Controllers Page]] - Find out about using Hercules GPL Linux MIDI driver with Mixxx, and where to get updated Hercules device control mappings for Windows and OSX.
  *[[Hardware Compatibility]]
  *[[FAQ]]
  *[[Troubleshooting]]
  *[[Tutorials]]
  *[[Add-ons]]
  *[[Vinyl Control|Vinyl (and audio CDJ) control]]
  *[[Internet broadcasting]]
  *[[System Requirements]]
  *[[Reporting bugs]]

===== Build Mixxx =====

  *[[Compiling on Linux]]
  *[[Compiling on Windows]]
  *[[Compiling on OS X]]

  *[[Packaging / Making a Mixxx Installer ]]

  *[[Setting up an auto build "slave"]]

===== Mixxx Developer Reference Documentation =====
  * **[[1.8.0_to_do_list|To-do list before the next release]]** - Please check this and contribute where you can so we can release sooner!

==== Getting Started ====
    *[[Using Bazaar|How the hell to use Bazaar]]
    *[[Development Roadmap]]
    *[[Submitting Patches]]
    *[[Creating backtraces]]
    *[[Coding Guidelines]]
    *[[Developer Tools]]
    * Tutorial: [[Adding a new button to Mixxx's interface]]
==== Editing MIDI mappings & scripts ====
    *[[MIDI Controller Mapping File Format]] - Read this to find out how to create or change a MIDI mapping file for your controller
    *[[midi_controller_mapping_file_format#ui_midi_controls_and_names|UI/MIDI Controls and Names]] - This is a list of Mixxx's controls you can manipulate with your MIDI controller via the mapping file and/or a script
    *[[MIDI Scripting]] - This explains how you can take complete control over your MIDI controller and create advanced behaviors including easy wheel scratching.

==== Development Topics ====
    *[[Performance improvements]]
    *[[code_cleanup|Code cleanup & cruft removal task list]]
    *[[feature_discussion|Feature Discussion & Specifications]]
    *[[Portable Mixxx|Portable Mixxx for removable media (Memory Sticks, CD/DVD, Portable HDDs)]]
    *[[MixxxScript]]
    *[[LADSPA]]
    *[[Testing framework]]

==== Interfaces ====
    *[[SoundSource interface (sound proxies)]]
==== Other Resources ====
    *[[Threads]]
    *[[Widgets]]
    *[[Pitch percentages for semitones and notes]]
    *[[Command line options]]
    *[[Fixes for Qt Deprecations]]
  * **Past development sprints:**
    * [[Coding Day Activities|July 29th 1.6.0 coding day]]
  * **Past developer meetings:**
    * [[9/20/2009 Developer Meeting Minutes]]
    * [[5/17/2009 Developer Meeting Minutes]]
    * [[6/27/2010 Developer Meeting Minutes]]
===== Artist Documentation =====

  *[[Creating Skins]]
  *[[Skin Guidelines]]
  *[[Skin Colour Scheme Architecture]]
  *[[On Icons and Images]]

===== Google Summer of Code =====

GSoC 2010: Mixxx is happy to announce that we are taking part in GSoC 2010, the student application period opens shortly

  * See the list of projects on offer on our ideas page: [[gsoc2010ideas]]
  * Some advice for students thinking of applying: [[gsoc2010advice]]

The following projects were accepted for Google Summer of Code 2010:

  * [[gsoc2010/effects_units|Effects Units]] by Bruno Buccolo
  * [[gsoc2010/sampler|Sampler]] by Ryan Baker
  * [[gsoc2010/dvs_mode|DVS Mode]] by Bill Good


GSoC 2009: Due to a lack of core developer time Mixxx did not participate in GSoC 2009.

The following projects were accepted for Google Summer of Code 2008:

  *[[gsoc2008/waveform_rewrite|Waveform Rewrite]] by RJ Ryan
  *[[gsoc2008/midi_control|MIDI Control]] by Tom Care
  *[[gsoc2008/internet_broadcasting|Internet Broadcasting]] by Wesley Stessens
  *[[gsoc2008/stability_and_crash_recovery|Stability and Crash Recovery]] by Zach Elko

Additional [[SoC Student Info]] from GSoC 2008

===== Past Events =====
  * [[cheapaschips20080309|Cheap as Chips, March 9th, 2008]] - Christchurch, New Zealand (Kid 90)
  * [[haz200704012|Carleton CS Bash, April 12th, 2007]] - Ottawa, Canada (Christian Muise)
  * [[kickadamkegger20070405|Kick Adam Kegger - April 5th, 2007]] - London, Canada (Albert Santoni and Peter Wright)
  * [[convergence20061013|Convergence, October 13th, 2006]] - Club Medussa, Brixton, London, UK (Tim Jackson) 
===== More Resources =====
  * Discussions on the [[https://lists.sourceforge.net/lists/listinfo/mixxx-devel|mixxx-devel]] mailing list are the basis for much of the content here.
  * The main [[http://www.mixxx.org|Mixxx website]].
  * Our [[http://www.launchpad.net/mixxx/|Launchpad project page]] and [[https://bugs.launchpad.net/mixxx/|bug tracker]].
  * The IRC Channel: #mixxx on [[http://freenode.net/|Freenode]].
  * The blog: [[http://mixxxblog.blogspot.com|mixxxblog.blogspot.com]] and [[previous polls]].
  * Bazaar code browsing on [[https://code.launchpad.net/mixxx|Launchpad]]. (Old SVN code browsing on [[http://mixxx.svn.sourceforge.net/viewvc/mixxx/|Sourceforge]].)