Superminaren
/
sample-hive
mirror of https://gitlab.com/samplehive/sample-hive.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
A simple, modern audio sample browser/manager for GNU/Linux.
112 Commits 5 Branches 1 Tag 1.6 MiB
C++ 96.8%
Meson 3.2%
Go to file
apoorv569 b367a9d895 Add experimental Windows build. 2022-02-15 22:54:44 +05:30
.builds fixup! Initial commit on SourceHut 2021-10-25 17:52:44 +05:30
.gitlab/issue_templates Update Bug.md 2021-07-25 06:21:31 +00:00
assets Add experimental Windows build. 2022-02-15 22:54:44 +05:30
src Add experimental Windows build. 2022-02-15 22:54:44 +05:30
subprojects Add check for darwin and restricted wx to v3.1.5. 2022-02-10 20:42:08 +05:30
.dir-locals.el More encapsulation and add new class Signal for handling custom events. 2021-12-13 23:42:12 +05:30
CONTRIBUTING.org Add CONTRIBUTING.org 2021-07-25 12:02:44 +05:30
LICENSE Initial commit 2021-03-20 04:19:12 +05:30
README.org Add experimental Windows build. 2022-02-15 22:54:44 +05:30
meson.build Add experimental Windows build. 2022-02-15 22:54:44 +05:30

README.org

SampleHive

<p align="center"> <img src="assets/icons/icon-hive_256x256.png" alt="samplehive-icon" width="256" height="256"> </p> <h1 align="center"> SampleHive </h1> <p align="center"> <h3 align="center"> A simple, modern audio sample browser/manager for GNU/Linux. </h3> <img src="assets/logo/logo-samplehive_1920x1080.png" alt="samplehive-logo" width=890> <hr> </p>

Table of contents   toc

What is SampleHive?

SampleHive let's you manage your audio samples in a nice and simple way, just add a directory where you store all your samples, or drag and drop a directory on it to add samples to it, and it will help sort, search, play and view some information about the sample. You can also drag and drop from SampleHive to other applications.

  • Dark
samplehive-screenshot-dark
  • Light
samplehive-screenshot-light

Dependencies

On Arch based distributions,

sudo pacman -S wxgtk3 sqlite taglib yaml-cpp libsndfile spdlog

On Debian, Ubuntu and distributions based the on two,

sudo apt install libwxbase3.0-dev libwxgtk-media3.0-gtk3-dev libwxgtk3.0-gtk3-dev wx3.0-headers libsqlite3-dev libyaml-cpp-dev libtagc0-dev libtag1-dev libtagc0 libexif-dev libpango1.0-dev libsndfile1-dev libspdlog-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-bad1.0-dev

You might also need to install git, cmake, meson and g++ as well, if you don't already have them installed in order to build SampleHive.

NOTE: On Debian and Debian based distributions you also have to install libwxgtk-media3.0-dev

Experimental Windows Build: If you want to try out SampleHive on Windows, you can use the MSYS2 environment and MinGW compiler for Windows. After setting up MSYS2 and MinGW install the following dependencies using the package manager pacman.

pacman -S mingw-w64-x86_64-wxmsw3.1 mingw-w64-x86_64-sqlite mingw-w64-x86_64-taglib mingw-w64-x86_64-yaml-cpp mingw-w64-x86_64-libsndfile mingw-w64-x86_64-spdlog mingw-w64-x86_64-meson  mingw-w64-x86_64-cmake git

How to build SampleHive?

Download the source code from this repository or use a git clone:

git clone https://gitlab.com/samplehive/sample-hive
cd sample-hive
meson build -Dprefix=/tmp/SampleHive
ninja -C build install

This will install SampleHive under /tmp/SampleHive.

The configuration file will be placed under ~/.config/SampleHive/config.yaml and the database file will be placed under ~/.local/share/SampleHive/sample.hive

NOTE: If you don't provide the -Dprefix=/tmp/SampleHive by default it will be installed under /usr/local. You can set the prefix to anything you want.

How to run SampleHive?

To run SampleHive:

If you provided a prefix, you can go the prefix directory then go to the bin directory and run the SampleHive binary, for example, assuming the prefix was set to /tmp/SampleHive

cd /tmp/SampleHive/bin
./SampleHive

If you didn't provide a prefix, you can find SampleHive in your menu system or run launcher and run SampleHive as you would run any other program on you system.

Are there any keybindings for SampleHive?

// TODO

Can I configure SampleHive?

SampleHive comes with a config.yaml file, that is placed under ~/.config/SampleHive/config.yaml, that you can edit to change some settings for it.

How do I contribute to the SampleHive?

Want to help by contributing to SampleHive, please check out CONTRIBUTING.org for more details.