mirror of
https://codeberg.org/armin/justasample.git
synced 2026-09-01 04:10:48 +02:00
109 lines
4.8 KiB
Markdown
109 lines
4.8 KiB
Markdown
<p align="center"><img src="Assets/Features/ui-armin.jpg" width="80%" alt="Screenshot of plugin" /></p>
|
|
|
|
# Just a Sample
|
|
|
|
> **Note:** This is a fork of [Just a Sample](https://github.com/BOBONA/Just-a-Sample) by Binyamin Friedman.
|
|
|
|
[Binyamin's Git project page (on GitHub)](https://bobona.github.io/just-a-sample/)
|
|
|
|
[Promo video (by Binyamin)](https://www.youtube.com/watch?v=P7dgOe_frXw)
|
|
|
|
Available for Windows, Mac, and Linux in VST3/AU (if you manage to compile, that is, for pre-built binaries, see Binyamin's page).
|
|
|
|
## Overview
|
|
Just a Sample is a powerful, _modern_ audio sampler, with a focus on simplicity and ease of use, written by Binyamin.
|
|
This is just my personal fork of the project.
|
|
|
|
## Features
|
|
|
|
[Detailed feature list](FEATURES.md)
|
|
|
|
#### Core features
|
|
- Smoothly zoom in to the level of individual samples to
|
|
set bounds as accurately as you need. Waveform drawing is **optimized** for large samples.
|
|
- Integrated [Bungee time stretcher](https://github.com/kupix/bungee) allows for
|
|
freely modulating time and pitch independently. Try extreme slow-downs (0.01x) for unique sounds.
|
|
- Modern navigation controls allow for easy browsing of waveforms with touchpad or mouse.
|
|
- A routable FX chain includes reverb, chorus, distortion, and EQ for easy sound design.
|
|
- Waveform Mode activates when small bounds are set, looping the waveform periodically like a wavetable synth. This turns Just a Sample into a unique tone generator.
|
|
- Easily modify attack and release curves.
|
|
- Includes equal power cross-fade looping with separate attack and release sample portions.
|
|
- Supports pitch bend and fine-tuning.
|
|
|
|
#### Extras
|
|
- Disable antialiasing for a gritty LoFi effect.
|
|
- Record samples directly into the sampler.
|
|
- Store samples directly in plugin state to remove dependencies (can be disabled).
|
|
- Auto-tune to A440 (experimental, works best on simple sounds).
|
|
|
|
## Installation
|
|
### We only allow build from source here, sorry, see Binyamin's page for pre-built releases
|
|
Just a Sample is easy to build from source.
|
|
|
|
```bash
|
|
# Clone the repository
|
|
git clone --recurse-submodules https://github.com/BOBONA/Just-a-Sample/.git
|
|
|
|
# Go to the project root
|
|
cd Just-a-Sample
|
|
|
|
# Configure the plugin (replace <platform> with windows, mac, or linux)
|
|
cmake --preset=<platform>
|
|
|
|
# Build the plugin
|
|
cmake --build --preset=release-<platform>
|
|
```
|
|
|
|
Note that the first time you configure the project, CMake will download JUCE and other dependencies, which may take a while.
|
|
|
|
Your built plugin will be located in `out/build/<platform>/<configuration>/JustASample_artefacts/<Configuration>/<format>/` where `<platform>` is windows, mac, or linux, `<configuration>` is either debug or release, and `<format>` is either VST3 or AU (Mac only).
|
|
|
|
#### Build Options
|
|
|
|
You can set the following CMake options by passing `-D<option>=<value>` to the CMake configure step.
|
|
|
|
- `JAS_DARKMODE_DEFAULT`: Set the default theme to dark mode (default: OFF)
|
|
- `JAS_VST3_REAPER_INTEGRATION`: Enable Reaper-specific VST3 extensions (Windows only, default: OFF)
|
|
|
|
#### Requirements
|
|
|
|
**All Platforms:**
|
|
- Git
|
|
- CMake 3.22 or higher
|
|
- Platform-specific build tools
|
|
|
|
**Windows:**
|
|
- Ninja build system
|
|
- Visual Studio 2019 or later
|
|
|
|
**macOS:**
|
|
- Xcode 12 or later
|
|
|
|
**Linux:**
|
|
- GCC 9+
|
|
- Ninja build system
|
|
- JUCE dependencies (install via the provided script, or do it yourself):
|
|
```bash
|
|
./Releases/Linux/install-dependencies.sh
|
|
```
|
|
|
|
### Dependencies
|
|
Just a Sample relies on:
|
|
- [JUCE](https://juce.com/) for plugin framework and UI
|
|
- [Bungee](https://bungee.parabolaresearch.com/) for time-stretching and pitch-shifting
|
|
- [Melatonin Blur](https://melatonin.dev/manuals/melatonin-blur/) for fast shadow-compositing
|
|
- [LEAF](https://github.com/spiricom/LEAF) for a fast pitch-detection algorithm
|
|
- [readerwriterqueue](https://github.com/cameron314/readerwriterqueue) for lock-free thread communication
|
|
- [Gin](https://github.com/FigBug/Gin) for AirWindows distortion and SimpleVerb reverb algorithms
|
|
- [MTS-ESP](https://github.com/ODDSound/MTS-ESP/tree/main/Client) for microtuning support
|
|
- [reaper-sdk](https://github.com/justinfrankel/reaper-sdk/tree/main/sdk) for Reaper-specific VST3 extensions
|
|
|
|
JUCE, Bungee, Melatonin Blur, and LEAF are included through [CMake](CMakeLists.txt#L29), readerwriterqueue is included as a
|
|
git [submodule](.gitmodules), and the others are included as source files [in the project](External).
|
|
|
|
## Credits
|
|
Big shouts going out to **Binyamin Friedman** - Creator of the original [Just a Sample](https://github.com/BOBONA/Just-a-Sample). Thank you for building such an elegant and well-designed sampler, and for making it open source for the community to learn from and build upon. Thank you Binyamin, I learned a lot from you.
|
|
|
|
Also special thanks to the JUCE project, Codeberg e.V., and the Audio Programmer Discord for all your awesome work and support. I'm standing on the shoulders of giants.
|
|
|
|
|