Skip to content

musictheory/loris

Repository files navigation

musictheory.net changes

This is a fork of the last public release (1.8) of Loris with select changes for Python 3 compatibility.

Installation on macOS

Use the following instructions to build on macOS Sonoma with the Xcode-provided python3.

Building SWIG

  1. Download swig from https://www.swig.org/download.html.
  2. Download the latest pcre2 .tar.gz from https://github.com/PCRE2Project/pcre2/releases.
  3. gunzip the pcre2 .tar.gz, then place the tar in the swig directory.
  4. Go into the swig directory and run ./Tools/pcre-build.sh
  5. Run ./configure --with-swiglibdir=$PWD/Lib
  6. Run make

Building Loris

cd loris

# Change this to your built swig
export SWIG=$(realpath "../swig-4.3.0/swig")

export XCODEDEV=$(xcode-select --print-path)
export PYTHON=$(readlink -f "$XCODEDEV/usr/bin/python3")
export MY_SITE_PACKAGES=$($PYTHON -m site --user-site)

./configure CPPFLAGS=-I"$(dirname $PYTHON)/../Headers"

make

# ---------------------------------------------------------------------
# Fixup dyld paths

install_name_tool -id "libloris.dylib" src/.libs/libloris.13.dylib

install_name_tool -change \
    "/usr/local/lib/libloris.13.dylib" \
    "@loader_path/libloris.dylib" \
    scripting/.libs/_loris.so

# ---------------------------------------------------------------------
# Manually copy results into user "site-packages" directory

cp src/.libs/libloris.13.dylib $MY_SITE_PACKAGES/libloris.dylib
cp scripting/.libs/_loris.so scripting/loris.py $MY_SITE_PACKAGES

Original README

Welcome to Loris.

Loris is an open source C++ class library implementing analysis, manipulation, and synthesis of digitized sounds using the Reassigned Bandwidth-Enhanced Additive Sound Model.

For more information about Loris and the Reassigned Bandwidth-Enhanced Additive Model, contact the developers at [email protected], or visit them at http://www.cerlsoundgroup.org/Loris/.

The primary distribution point for Loris is SourceForge (http://loris.sourceforge.net) and its mirrors.

Loris is free software. Please see the file COPYING for details.

For documentation, please see the files in the doc subdirectory.

For a list of major changes to Loris, organized by release number, please see the file NEWS.

INSTALLATION:

For generic configuration and installation instructions, see the file INSTALL.

In order to compile and link the Loris library and scripting extensions, you will need a modern, reasonably standard-compliant C++ compiler (and linker, etc.). To build scripting extensions, such as the Python module, you will also need SWIG, a tool that connects programs written in C and C++ with a variety of high-level programming languages, available at www.swig.org

For best performance, you should also install the FFTW Fourier transform library, available at www.fftw.org. Mac OS X users see note below. FFTW is covered by its own license and copyright, and is entirely separate from Loris. FFTW is not required to build or use Loris.

MacOS INSTALLATION:

Loris can be built using the standard GNU tools from a Terminal window under Mac OS X (Darwin), follow the instructions for the standard distribution. You will, of course, need the developers' tools, available from Apple, in order to compile Loris (or anything else) under OS X. It is also possible to build Loris using Xcode under OS X.

NOTE: By default, FFTW builds and installs only static libraries under Mac OS X. Loris needs to link against the dynamic FFTW library. You need to explicitly enable dynamic linking when building FFTW so that the dynamic (shared) library is built.

COPYRIGHT AND LICENSE:

Loris is Copyright (c) 1999-2010 by Kelly Fitz and Lippold Haken

Loris is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY, without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the file COPYING or the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

[email protected] http://www.cerlsoundgroup.org/Loris/

About

Fork of CERL Sound Group's Loris

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published