One page summary of how to start a new Cindy project.
Before using the theme, you need to install some dependencies. Cindy uses
ffmpeg to analyze media files and it uses
sqlite to store metadata. Here
is how you can install the necessary packages on Debian
apt install libavformat-dev libavutil-dev sqlite3-dev
To install Cindy, you have two options. You can download a nightly release, which is the easiest way to get started. You can also install it from source, which may be required if you want to use it on a platform that does not have a release build automatically.
Go to the Releases page and download a release for your platform. You may need to unpack it or mark it as executable, depending on your operating system.
Clone the repository and build it from source. You need to build the frontend separately.
git clone https://gitlab.com/xfbs/cindy
trunk build --release
cargo build --release
You can also build Cindy using Docker, which should be easier if you do not have the build dependencies installed on your host system.
You do not need any configuration to use Cindy. All you need to do is
initialize a new Cindy project, which you can do like this. Cindy will create a
myproject for you.
cindy init myproject
You can also initialize an already existing folder as a Cindy project.
cindy init .
Next, you can add files (they will be scanned and indexed):
cindy add -r .
You can also add individual files, like this:
cindy add podcast.mp3 video.avi
Finally, you can start the server and explore the interface:
After you launched this command, you should be able to connect to Cindy at http://localhost:8000.