File: README.md

package info (click to toggle)
freewheeling 0.6.4-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 3,244 kB
  • sloc: cpp: 24,079; xml: 3,631; ansic: 1,818; sh: 1,232; makefile: 31
file content (183 lines) | stat: -rw-r--r-- 8,332 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183

<table>
  <tr>
    <td><img src="https://github.com/free-wheeling/freewheeling/wiki/freewheeling-logo-1.jpg" /></td>
    <td><b>Freewheeling is live looper software.</b>
           <br />
           This wiki enables the Freewheeling community to collaborate on documentation.
           <br />
           The main Freewheeling website can be found at:
           <a href="http://freewheeling.sourceforge.net/">http://freewheeling.sourceforge.net/</a>
    </td>
  </tr>
</table>


Introduction to Freewheeling
----------------------------

![freewheeling screenshot][Freewheeling_Screenshot]

### Free and Open Source Audio Tool for Live Looping

Freewheeling provides a highly configurable, intuitive, and fluid user
interface for instrumentalists to capture audio loops in real-time. Best
way to understand Freewheeling?? [See and hear
it](http://freewheeling.sourceforge.net/shots.shtml) in action. [Demo
Video](http://freewheeling.sourceforge.net/video/fw-demo1.avi)

### Philosophy

```
Freewheeling is
a new way 'to be'
In The Muse-ical Moment.
It's a live looping instrument
that returns us to the joy
of making music 'spontaneously'.
```

Freewheeling allows us to build repetitive grooves by sampling and
directing loops from within spirited improvisation. It works because,
down to the core, it's built around improv. We leave mice and menus, and
dive into our own process of making sound. The principle author of
Freewheeling is JP Mercury. Freewheeling was also originally a Max/MSP
external.

### Technical Details

Freewheeling runs under GNU/Linux (PC/Mac) and Mac OS X (PPC/Intel)
using the [Jack Audio Connection Kit](http://jackaudio.org), and
is Free and Open Source Software, released under the GNU GPL license.
The ChangeLog is a good resource, because all major new features have
been documented there. It is humble enough to run on modest hardware but
can take advantage of the gobs of RAM on modern machines as well. The
only limits are your imagination.

**Focus on the ideation process:**

-   Freewheeling empowers the trance of immediate creativity by bringing
    us into a circular process. Time is utterly relative, and we are
    freed from the future-oriented mindset of product sequencing. If
    inspiration flows, later arranging and editing on a timeline can be
    done with other tools.

See the [Technical Features][Technical_Features].


Getting Started
---------------

### Downloading

Pre-compiled Freewheeling binaries are available for several of today's
popular operating systems. If you prefer using your favorite graphical
package manager (such as synaptic) or your distro's Add/Remove Software
Control Panel, search for a package named *freewheeling* or *fweelin*.

-   Install one of the [OS Specific Packages][OS_Specific_Packages] - (recommended)
-   or, [Download](https://github.com/free-wheeling/freewheeling/releases)
    a tarball - (advanced)
-   or, Debian, KxStudio, Mint, and Ubuntu users can download the
    sourecs with your package manager: - (advanced)

```
    $ apt source freewheeling
```

-   or, Checkout the latest git master - (advanced)

```
    $ git clone https://github.com/free-wheeling/freewheeling.git
    $ git clone https://notabug.org/freewheeling/freewheeling.git
```

### Installing

-   [OS Specific Packages][OS_Specific_Packages] - (recommended)
-   [Compiling][Compiling] - (advanced)
-   [Dependencies][Dependencies]

### Configuring

-   [Configuration Basics][Configuration_Basics] - how does it work?
-   [XML Configuration System][XML_Configuration_System] -
    the full Freewheeling XML API from config-help.txt in wiki form
-   [Configurations][Configurations] -
    a store for users to submit their custom interfaces, layouts, patches, etc

### Troubleshooting and Support

-   [FAQS][FAQS] - Freeq-wheely Asked Questions
-   [Known Issues][Known_Issues] - Resolutions to common
    pitfalls, snags, and glitches (notice i did not say bugs)
-   [Freewheeling Users Mailing List][Freewheeling_Users_Mailing_List] -
    If you're looking for help with Freewheeling,
    your question may already be answered there. If not, feel free to
    [join the mailing list](https://lists.sourceforge.net/lists/listinfo/freewheeling-user)
    and ask your question to the community
-   [Feature Requests][Freewheeling_Users_Mailing_List] -
    Please join the 'freewheeling-user' mailing list
-   [Bug Reporting](https://github.com/free-wheeling/freewheeling/issues) -
    Please reports bugs on the GitHub issue tracker or the
    [NotABug issue tracker](https://notabug.org/freewheeling/freewheeling/issues)

### Using

-   [Quick Start Guide][Quick_Start_Guide] - handy defaults for the impatient user
-   [Freewheeling Video Tutorials][Freewheeling_Video_Tutorials] - watch
    freewheeling in action
-   [Controlling Freewheeling][Controlling_Freewheeling] - using external midi devices
-   [Default Key Bindings][Default_Key_Bindings] - what did I just pressed?
-   [Tips and Tricks for Studio and Live Use][Tips_and_Tricks_for_Studio_and_Live_Use]

NOTE: You'll also need JACK and a way to configure it (such as qJackCtl
or Cadence). A very easy way to setup a GNU/Linux audio workstation is
by installing the Ubuntu-based [KxStudio Operating
System](http://kxstudio.linuxaudio.org/Downloads). Debian (and
derrivatives such as Ubuntu and Mint) can transform their system into
KxStudio simply by adding the [KxStudio
repos](http://kxstudio.linuxaudio.org/Repositories) and installing the
'kxstudio-meta-all' package (or 'kxstudio-meta-audio' for just the
pro-audio programs). It is highly recommended that you install at least
the 'kxstudio-default-settings' package which optimizes your system
performance for real-time audio use.


The Freewheeling Community
--------------------------

### Community Interaction

-   [Music made with Freewheeling][Music_made_with_Freewheeling]
-   [Freewheeling Users Mailing List][Freewheeling_Users_Mailing_List] -
    technical support, new releases, shared ideas and music

### How can I help?

-   Submit or edit wiki articles
-   Submit your interfaces and layouts for specific hardware to the
    [Configurations][Configurations] article
-   Submit screen-casts demonstrating your interfaces or the advanced
    features of freewheeling
-   Submit audio/video creations to the
    [Music made with Freewheeling][Music_made_with_Freewheeling] article


[Freewheeling_Screenshot]:                 http://freewheeling.sourceforge.net/flo-051-looptray-t.png
[Technical_Features]:                      https://github.com/free-wheeling/freewheeling/wiki/Technical-Features
[OS_Specific_Packages]:                    https://github.com/free-wheeling/freewheeling/wiki/OS-Specific-Packages
[Compiling]:                               https://github.com/free-wheeling/freewheeling/wiki/Compiling
[Dependencies]:                            https://github.com/free-wheeling/freewheeling/wiki/Dependencies
[Configuration_Basics]:                    https://github.com/free-wheeling/freewheeling/wiki/Configuration-Basics
[XML_Configuration_System]:                https://github.com/free-wheeling/freewheeling/wiki/XML-Configuration-System
[Configurations]:                          https://github.com/free-wheeling/freewheeling/wiki/Configurations
[FAQS]:                                    https://github.com/free-wheeling/freewheeling/wiki/FAQS
[Known_Issues]:                            https://github.com/free-wheeling/freewheeling/wiki/Known-Issues
[Quick_Start_Guide]:                       https://github.com/free-wheeling/freewheeling/wiki/Quick-Start-Guide
[Freewheeling_Video_Tutorials]:            https://github.com/free-wheeling/freewheeling/wiki/Freewheeling-Video-Tutorials
[Controlling_Freewheeling]:                https://github.com/free-wheeling/freewheeling/wiki/Controlling-Freewheeling
[Default_Key_Bindings]:                    https://github.com/free-wheeling/freewheeling/wiki/Default-Key-Bindings
[Tips_and_Tricks_for_Studio_and_Live_Use]: https://github.com/free-wheeling/freewheeling/wiki/Tips-and-Tricks-for-Studio-and-Live-Use
[Music_made_with_Freewheeling]:            https://github.com/free-wheeling/freewheeling/wiki/Music-made-with-Freewheeling
[Freewheeling_Users_Mailing_List]:         https://github.com/free-wheeling/freewheeling/wiki/Freewheeling-Users-Mailing-List