Skip to content

Latest commit

 

History

History
93 lines (52 loc) · 3.58 KB

README.md

File metadata and controls

93 lines (52 loc) · 3.58 KB
Raw

README

Build Status Scrutinizer Code Quality

Usage hints

Commands

Following commands are available(see script occ in your ownCloud root folder):

Scan music files

./occ music:scan USERNAME1 USERNAME2 ...

This scans all not scanned music files of the user USERNAME and saves the extracted metadata into the music tables in the database. This is also done if you browse the music app web interface. There the scan is done in steps of 20 tracks and the current state is visible at the bottom of the interface.

./occ music:scan --all

This scans music files for all users.

Both of the above commands can be combined with the --debug switch, which enables debug output and shows the memory usage of each scan step.

Reset scanned metadata

Warning: This command will delete data! It will remove unavailable tracks from playlists as playlists are linked against the track metadata.

./occ music:reset-database USERNAME1 USERNAME2 ...

This will reset the scanned metadata of the provided users.

./occ music:reset-database --all

This will reset the scanned metadata of all users.

Ampache

In the settings the URL you need for Ampache is listed and looks like this:

https://cloud.domain.org/index.php/apps/music/ampache/

This is the common path. Some clients append the last part (server/xml.server.php) automatically. If you have connection problems try the longer version of the URL with the server/xml.server.php appended.

Authentication

To use Ampache you can't use your ownCloud password. Instead, you need to generate APIKEY for Ampache. Go to "Your username" → "Personal", and check section Music/Ampache, where you can generate your key. Enter your ownCloud username and the generated key as password to your client.

Installation

Music App can be installed from Appstore by following the instructions here or using App Management in ownCloud with instructions written here

Known issues

Huge music collections

The current version doesn't scale well for huge music collections. There are plans for a kind of paginated version, which hides the pagination and should be useable as known before. #78

Application can not be activated because of illegal code

The current music app can't be installed and ownCloud prints following error message: "Application can not be activated because of illegal code". This is due to the appcodechecker in core (which is kind of broken), but you can do the installation if the appcodechecker is deactivated:

  • set appcodechecker to false in config.php (see the config.sample.php )
  • now you can install the app
  • afterwards re-enable the appcodechecker

Development

L10n hints

Sometimes translatable strings aren't detected. Try to move the translate attribute more to the beginning of the HTML element.

Build appstore package

git archive HEAD --format=zip --prefix=music/ > build/music.zip

Run tests

PHP tests

phpunit tests/php
phpunit --coverage-html coverage-html tests/php

3rdparty libs

update JavaScript libraries

cd js
bower update