Skip to content

Latest commit

 

History

History
42 lines (30 loc) · 2.71 KB

master_development guide.md

File metadata and controls

42 lines (30 loc) · 2.71 KB

Master Development Guide

By: Tim Curtis (c) 2022 Updated: 2022-03-11

This guide provides information on how to get started developing for moOde.

Table of Contents

1. Overview

moOde audio player is a Web application consisting of a front-end UI written in HTML/CSS and Javascript, and a back-end wrapper for Music Player Daemon (MPD) written in PHP plus a variety of utilities written in PHP, BASH and Python. AJAX and PHP templates are used for sending data between the front-end and back-end. The data format is either $_POST associative arrays or JSON.

Bootstrap and JQuery frameworks are used for front-end implementation. The Zend Media framework is used in the back-end for extracting embedded cover art images from FLAC, MP3 and M4A audio file formats. The Web stack uses NGINX, SQLite3 and PHP-FPM.

2. The repositories

To start developing for moOde it's necessary to first become familiar with the source repositories on Github. They are located at (https://github.com/moode-player) and are listed below. Follow this by consulting individual reference materials listed in section 3.

Repository Description
docs Documentation
moode moOde sources and configs
imgbuild Scripts to generate a custom OS image for moOde
pkgbuild Scripts to build third-party packages for moOde
pkgsource Sources for third-party packages used by moOde

3. Reference materials

The following reference materials provide details on the structure of moOde and on how to use the Build Tooling to generate the front-end and back-end, configure and build packages and build the ISO image.

Document Description
Source tree Function of each directory and file in the moode repository source tree
Development with Gulp This developer guide explains how to use the Gulp toolkit to automate building the moOde front-end.
Building Debian packages This developer guide describes how Debian packages are used in moOde.
Build the moode-player package his developer guide explains how to build the moOde-player package from sources.
moOde audio infrastructure This document describes the audio infrastructure of moOde audio player.