/dopamine

The audio player that keeps it simple

Primary LanguageTypeScriptGNU General Public License v3.0GPL-3.0

Dopamine

Dopamine

Dopamine is an elegant audio player which tries to make organizing and listening to music as simple and pretty as possible. This version is written using Electron, Angular and Typescript. The original Dopamine (for Windows), which is written in WPF and C#, remains available here.

Dopamine icons created by Sharlee.

Release GitHub Workflow Status Issues Donate

Buy Me a Coffee at ko-fi.com

Dopaminescreenshot

Build prerequisites

  • rpm: required to build rpm package
  • libarchive-tools: contains bsdtar, which is required to build pacman package.

Build prerequisites on Ubuntu:

  • Install Node.js LTS
  • Install Visual Studio Code
  • Install rpm (required to build rpm package) and libarchive-tools (contains bsdtar, which is required to build pacman package): sudo apt install rpm libarchive-tools

Follow the build instructions below to start or build Dopamine for your platform.

Build prerequisites on Manjaro:

  • Install Node.js LTS:
    • yay -S nvm
    • nvm install 14
  • Install Visual Studio Code: yay -S visual-studio-code-bin
  • Install rpm (required to build rpm package): sudo pacman -S rpm-tools

Follow the build instructions below to start or build Dopamine for your platform.

Build prerequisites on Windows:

  • Download and install Node.js LTS from https://nodejs.org (During the installation, select all features and check the box to install Tools for Native Modules).
  • After the installation of Node.js, restart computer to ensure that npm is added to the path.
  • Download and install Visual Studio Code from https://code.visualstudio.com/
  • Download the Dopamine source code
  • Open Visual Studio Code and open the "dopamine" folder (the folder containing package.json)

Follow the build instructions below to start or build Dopamine for your platform.

Build prerequisites on MacOS:

  • Install Node.js LTS from https://nodejs.org (During the installation, select all features and check the box to install Tools for Native Modules).
  • Make sure npm is accessible via the console
    • Press command + space and search for console
    • Write npm --v and press enter, this should give you the version number if npm is properly installed.
  • Download and install Visual Studio Code from https://code.visualstudio.com/
  • Download the Dopamine source code
  • Open Visual Studio Code and open the "dopamine" folder (the folder containing package.json)

Build instructions

Due to the native dependency better-sqlite3, this project cannot be built for all platforms on GNU/Linux. The GNU/Linux packages must be built on GNU/Linux, the Windows package must be built on Windows and the MacOS package must be built on MacOS.

$ git clone https://github.com/digimezzo/dopamine.git
$ cd dopamine
$ npm install                # Install dependencies
$ npm start                  # Start Dopamine
$ npm run electron:windows   # Build for Windows
$ npm run electron:linux     # Build for Linux
$ npm run electron:mac       # Build for Mac

Pacman installation notes

The pacman package contains a dependency to package libappindicator-sharp, which is no longer distributed with Arch Linux. I cannot remove this dependency for now, because it is an issue in electron-builder (the packaging tool which is used in this project). It is, however, possible to install Dopamine on Arch Linux or Manjaro using this command:

$ sudo pacman -U Dopamine-3.0.0-preview.3.pacman --assume-installed libappindicator-sharp