BambooTracker

[Build Tests]

English | 日本語

BambooTrackerはNEC PC-8801/9801シリーズに搭載されていたFM音源YM2608(OPNA)向けのクロスプラットフォームのトラッカーです。

Wiki
コミュニティ
対応言語
ダウンロード
4.1. リリース (Windows, macOS, Linux)
4.2. 開発版ビルド (Windows, macOS)
4.3. パッケージ (macOS, Linux, BSD)
ショートカット
エフェクトリスト
ファイル入出力
ビルド方法
8.1. 依存関係
8.2. コンパイル
変更履歴
ライセンス
クレジット

Wiki

BambooTracker GitHub Wikiで以下の情報が得られます。

トラッカーって何？
BambooTrackerって何？何ができるの?
インターフェースの使い方と操作方法
BambooTrackerでYM2608を制御する方法

コミュニティ

公式Discordサーバーでは、BambooTrackerユーザーや開発者、パッケージメンテナーとチャットしたり、助けを求めたり、他の人を助けたり、自分の曲をシェアしたりすることができます。

対応言語

現在、BambooTrackerでは以下の言語に対応しています。

English / 英語 (デフォルト)
日本語
Français / フランス語
Polski / ポーランド語
Español / スペイン語

ダウンロード

リリース (Windows, macOS, Linux)

リリースは、優れた安定したエクスペリエンスを提供する必要があるため、ほとんどのユーザーに推奨されます。

開発版ビルド (Windows, macOS)

開発版のビルドはコードの変更がベースリポジトリにコミットされるたびにビルドされ、アップロードされます。そのため最新または開発中の機能や修正を提供しますが、通常の使用には最適化されていません。

ビルドの取得に関して、
- 最新のマージされたコミットは、
  master -o- (英数字)
  と表示されている一番上のもののみ参照してください。
  master -o- (英数字) ← 何らかのブランチ名 (英数字)
  ではありません。
- 特定のPull Requestは、左上の Pull request #(Pull Request ID)
  の表記を確認してください。
それ以外は、Historyタブから必要な物をお探しください。
"Job name"の欄にAPPVEYOR_JOB_NAME=for (OS名)と書かれた行を見つけてクリックします。
開いたページで、右側のArtifactsタブをクリックすると、ダウンロードページが表示されます。

パッケージ (macOS, Linux, BSD)

Nixpkgs (macOS, Linux)

Nixpkgsパッケージ: https://search.nixos.org/packages?query=bambootracker

宣言的インストール:

{
  environment.systemPackages = with pkgs; [
    bambootracker
  ];
}

強制インストール:

nix-env -iA nixpkgs.bambootracker

Debian / Ubuntu

sudo apt install bambootracker

Arch / Manjaro

AUR package: https://aur.archlinux.org/packages/bambootracker-git

FreeBSD

pkg install bambootracker

その他

ビルド方法の項を参照してください。

ショートカット

KEYCOMMANDS.mdを参照してください。

エフェクト一覧

EFFECTLIST.mdを参照してください。

ファイル入出力

FILEIO.mdを参照してください。

ビルド方法

依存関係

BambooTrackerをビルドする際には全てのプラットフォームで以下の依存関係を用意してください。

Qt (5.5以降)
Qt Tools (qmake, lrelease, ...)
QtでサポートされているC++コンパイラ (GCC, Clang, MSVC, ...)
make

それ以外の必須/オプションの依存関係を取得する方法は、OS(ディストリビューション)ごとに異なります。

Windows

C++コンパイラ: いずれかを利用できます。
- MinGW
  Qtインストーラにバンドルされているオプションを使用することをお薦めします。
  それ以外のものを使用する場合は、QtのドキュメントでQtのバージョンと互換性のあるGCCのバージョンを確認してください。
- Clang
  未テストですが恐らく動作します。
- MSVC
  Visual Studioにバンドルされているものか、スタンドアロン版("Build Tools for Visual Studio 2019"のダウンロードを確認してください)
Qt: 古いバージョンのQt(XPビルドなど)では、自分でチェックアウトしてコンパイルする必要があるかもしれませんが、公式のプリビルド版はQtによって削除されました。

macOS

ここではHomebrew & Qt5を用いた導入方法を紹介します。

C++コンパイラ: Xcode Command Line Tools
(開発者はmacOSを使っていないので、導入方法については検索してください。すみません)
Qt5:

brew install qt5

オプションの依存関係:

JACK: このリポジトリに含まれるRtAudio / RtMidiでのJACKサーバへの接続をサポートします。
JACK(バージョン1または2)のヘッダとライブラリが必要です。
```
brew install jack
```
オプション: pkg-configによってこの処理をスキップできますが、JACKのヘッダやライブラリの検出が困難になる可能性があります。
```
brew install pkg-config
```
RtAudio / RtMidi: このリポジトリで含んでいるものの代わりにコンパイル済みのRtAudio / RtMidiを使います。
(上記のオプションの依存関係は削除されます)
RtAudio (5.1.0以降)と/またはRtMidi (4.0.0以降) + pkg-configが必要です。
```
brew install rt-audio rt-midi pkg-config
```

Linux

依存関係のインストールは、お使いのディストリビューションとパッケージマネージャに大きく依存します。
お使いのディストリビューションの項を参照し、インストール手順をテストセットを確認してください。

追加の依存関係:

ALSA: 最小限のオーディオとMIDIをサポートするために必要です。
ALSAのヘッダとライブラリが必要です。

オプションの依存関係:

PulseAudio: リポジトリに含まれるRtAudioでPulseAudioサーバーへの接続をサポートします。
PulseAudioのヘッダとライブラリが必要です。
オプション: pkg-configによってこの処理をスキップできますが、PulseAudioのヘッダやライブラリの検出が困難になる可能性があります。
JACK: リポジトリに含まれるRtAudio / RtMidiでPulseAudioサーバーへの接続をサポートします。
JACK(version 1または2)ののヘッダとライブラリが必要です。
オプション: pkg-configによってこの処理をスキップできますが、JACKのヘッダやライブラリの検出が困難になる可能性があります。
RtAudio / RtMidi: このリポジトリで含んでいるものの代わりにコンパイル済みのRtAudio / RtMidiを使います。
(上記のオプションの依存関係は削除されます)
RtAudio (5.1.0以降)と/またはRtMidi (4.0.0以降) + pkg-configが必要です。

Debian / Ubuntu

# Optional dependencies
OPTIONALDEPS=""

# PulseAudio
OPTIONALDEPS="$OPTIONALDEPS libpulse-dev"

# Either:
# JACK 1
OPTIONALDEPS="$OPTIONALDEPS libjack-dev"
# JACK 2
OPTIONALDEPS="$OPTIONALDEPS libjack-jackd2-dev"

# Either / Both:
# System-RtAudio
OPTIONALDEPS="$OPTIONALDEPS librtaudio-dev"
# System-RtMidi
OPTIONALDEPS="$OPTIONALDEPS librtmidi-dev"

# Install dependencies
apt install \
  build-essential \
  qt5-default qttools5-dev-tools \
  libasound2-dev \
  $OPTIONALDEPS

Arch Linux / Manjaro

# Optional dependencies
OPTIONALDEPS=""

# PulseAudio
OPTIONALDEPS="$OPTIONALDEPS libpulse"

# Either:
# JACK 1
OPTIONALDEPS="$OPTIONALDEPS jack"
# JACK 2
OPTIONALDEPS="$OPTIONALDEPS jack2"

# Either / Both:
# System-RtAudio
OPTIONALDEPS="$OPTIONALDEPS rtaudio"
# System-RtMidi
OPTIONALDEPS="$OPTIONALDEPS rtmidi"

# Install dependencies
pacman -S \
  qt5-tools \
  alsa-plugins \
  $OPTIONALDEPS

BSD

以下を除けばLinuxと同じです:

ALSAはオプションです。
OSS4のヘッダとライブラリが必須です。

(もしあなたがBSDシステム上でBambooTrackerを手動でコンパイルできた場合は、Pull Requestを開いて依存関係のインストール手順をここに追加してください!)

コンパイル

これらのコンパイル手順はCLIの使用を前提としていますが、代わりにQt CreatorのようなIDEを使用することも可能です。これらは一般的にすべてのプラットフォームで動作するはずですが、特定の変更点については以下の項で言及しています。

Qmakeのオプション (フラグ/スイッチ):

PREFIX: ビルド後にインストールする場所です。
デフォルト:
- Windows: C:\BambooTracker
- macOS/Linux/BSD: /usr/local
  例: PREFIX=C:\Users\Owner\Programs\BambooTracker
CONFIG
複数回指定して複数のオプションを追加することができます。
オプションの追加には+=を、削除には-=を使用してください。
- debug: デバッグビルド。クラッシュをデバッグする際に有用です。
- release: リリースビルド。デバッグビルドよりも最適・コンパクトにビルドします。
- install_flat: インストール時にPREFIX下のLinux FHSパスを使用しません。(Windowsではデフォルトで有効)
- install_minimal: 不要なファイルのインストールをスキップします。
- use_alsa: 明示的にALSA¹に対応したリポジトリに含まれるRtAudioとRtMidiをコンパイルします。(Linuxではデフォルトで有効)
- use_oss: 明示的にOSS4²に対応してコンパイルします。(BSDではデフォルトで有効)
- use_pulse: 明示的にPulseAudio¹に対応したリポジトリに含まれるRtAudioをコンパイルします。
- use_jack: 明示的にJACK 1/2¹³に対応してコンパイルします。
- system_rtaudio: RtAudioのコンパイルをスキップし、代わりにシステムのインストールされているRtAudioにリンクします。
- system_rtmidi: RtMidiのコンパイルをスキップし、代わりにシステムのインストールされているRtMidiにリンクします。
- real_chip: SCCIとC86CTLに対応したコンパイルを行います⁴。(Windowsではデフォルトで有効)

¹: LinuxとBSDでのみ動作します。
²: FreeBSDでは自動検出されます(?)が、RtAudioでは機能しない可能性があります。
³: APIは技術的にはWindowsでサポートされていますが、Rtライブラリではコンパイルが困難なようです。
⁴: OSI認証ライセンスを使用しないコードをビルドします。これらはWindowsにのみ対応しています。

例:

# Where you want to locally keep the source code clone
cd /home/owner/devel

# Replace --recurse-submodules with --recurse-submodules=submodules/emu2149/src if CONFIG+=system_rtaudio AND CONFIG+=system_rtmidi will be used
git clone https://github.com/BambooTracker/BambooTracker --recurse-submodules
cd BambooTracker

# Configure
qmake PREFIX=/usr/local CONFIG-=debug CONFIG+=release CONFIG+=use_alsa CONFIG+=use_pulse CONFIG+=use_jack

# Recursively initialises subprojects properly, dependency tests may be flakey if run multithreaded
make qmake_all

# Compile with 4 threads
make -j4

# Installs to PREFIX
make install

Windows

上記の手順を始める前に、Qtとコンパイラをセットアップしたシェルに入ります。(Qtのインストーラには、このために使えるスクリプトが追加されています)

MinGWを使う場合はmakeではなくmingw32-make / mingw64-makeを使って下さい.
MSVCを使う場合はTODO。

Qt Creatorを使用すると、よりグラフィカルなコンパイル処理を行うことができます。

macOS

pkg-configを使わずにHomebrewのJACKを使用する際は、qmakeにいくつかの引数を渡します: LIBS+=-L/usr/local/opt/jack/lib INCLUDEPATH+=/usr/local/opt/jack/include

FreeBSD

BambooTrackerはFreeBSDのポートを使ってビルドすることができます。

cd /usr/ports/audio/bambootracker
make install clean

変更履歴

CHANGELOG.mdを参照してください。

ライセンス

このプログラム及びソースコードのライセンスははGNU General License Version 2及びそれ以降のバージョンです。

詳細はLICENSEとlicenses/list.mdを参照してください。

クレジット

このアプリの作成において、以下の方々にお世話になっております。ありがとうございます。

Qt
MAME YM2608のエミュレーションコードに関してTatsuyuki Satohさん，Jarek Burczynskiさん，Valley Bellさん
emu2149に関してDigital Sound Antiquesさん
トラッカーのアイコンに関してDecidettoさん
その他のアイコンに用いているSilk iconsに関してMark Jamesさん
VGMファイルのフォーマットのドキュメントに関してVGMRipsチームの方々
トラッカーのUIやルーチンに関して多くのトラッカー作成者様、特に0CC-FamiTrackerのHertzDevilさん、Deflemask TrackerのLeonardo Demartino (delek)さん、GoatTrackerのLasse Öörni (Cadaver)さん、Furnace Trackerのtildearrowさん
サンプル曲を提供してくださったmaakさん、SuperJet Spadeさん、Dippyさん、RigidatoMSさん、ImATrackManさん
サンプルインストゥルメントを提供してくださったpapiezakさん、阿保　剛さん
サンプルカラースキームを提供してくださったYuzu4Kさん
WOPNインストゥルメントのフォーマットファイルに関してVitaly Novichkov (Wohlstand)さん
S98ファイルのフォーマットのドキュメントに関してRu^3さん
SCCIライブラリに関してがし３さん
C86CTLライブラリに関してhonetさん
RtAudioとRtMidiライブラリに関してGary P. Scavoneさん他
Nuked OPN-Modエミュレーションに関してAlexey Khokholov (Nuke.YKT)さん、Jean Pierre Cimalandoさん
フランス語翻訳に関してJean Pierre Cimalandoさん、Olivier Humbertさん
ポーランド語翻訳に関してfreq-modさん、Midoriさん
スペイン語翻訳に関してbinarycasperさん
ADPCMエンコーダ/デコーダに関してIan Karlssonさん
ymfmに関してAaron Gilesさん
リサンプリングライブラリに関してShay Greenさん
そしてこのプロジェクトに手助けしてくださるみなさん!

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README_ja.md

README_ja.md

BambooTracker

目次

Wiki

コミュニティ

対応言語

ダウンロード

リリース (Windows, macOS, Linux)

開発版ビルド (Windows, macOS)

パッケージ (macOS, Linux, BSD)

Nixpkgs (macOS, Linux)

Debian / Ubuntu

Arch / Manjaro

FreeBSD

その他

ショートカット

エフェクト一覧

ファイル入出力

ビルド方法

依存関係

Windows

macOS

Linux

Debian / Ubuntu

Arch Linux / Manjaro

BSD

コンパイル

Windows

macOS

FreeBSD

変更履歴

ライセンス

クレジット

Files

README_ja.md

Latest commit

History

README_ja.md

File metadata and controls

BambooTracker

目次

Wiki

コミュニティ

対応言語

ダウンロード

リリース (Windows, macOS, Linux)

開発版ビルド (Windows, macOS)

パッケージ (macOS, Linux, BSD)

Nixpkgs (macOS, Linux)

Debian / Ubuntu

Arch / Manjaro

FreeBSD

その他

ショートカット

エフェクト一覧

ファイル入出力

ビルド方法

依存関係

Windows

macOS

Linux

Debian / Ubuntu

Arch Linux / Manjaro

BSD

コンパイル

Windows

macOS

FreeBSD

変更履歴

ライセンス

クレジット