Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nicfit/MishMash

Music database, etc.
https://github.com/nicfit/MishMash

eyed3 media music-library python sqlachemy

Last synced: about 1 month ago
JSON representation

Music database, etc.

Host: GitHub
URL: https://github.com/nicfit/MishMash
Owner: nicfit
License: gpl-3.0
Created: 2016-12-26T21:27:11.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2023-09-25T18:54:09.000Z (12 months ago)
Last Synced: 2024-07-26T15:47:21.471Z (about 2 months ago)
Topics: eyed3, media, music-library, python, sqlachemy
Language: Python
Homepage:
Size: 1.42 MB
Stars: 12
Watchers: 7
Forks: 4
Open Issues: 15
Metadata Files:
- Readme: README.rst
- Changelog: HISTORY.rst
- Contributing: CONTRIBUTING.rst
- License: LICENSE

Awesome Lists containing this project

project-awesome - nicfit/MishMash - Music database, etc. (Python)

README

        ========

MishMash

========

|Build Status| |License| |PyPI| |Python versions| |Coverage| |Status|

Music database and web interface.

Features

--------

* MishMash is a music database using `Python`_ and `SQLAlchemy`_.

* A command-line tool for building and managing a music database.

* Web browser interface (using `Pyramid`_) for browsing your music library.

* Uses `eyeD3`_ for reading MP3s and ID3 metadata.

* Support and tested with Python 3.6 and Postgresql. SQLite is periodically

  tested with, but future features may not be supported (e.g. full text

  search).

* Free software: GNU GPL v3.0 license

.. _Python: https://www.python.org/

.. _SQLAlchemy: http://www.sqlalchemy.org/

.. _eyeD3: http://eyeD3.nicfit.net/

.. _Pyramid: https://trypyramid.com/

Getting Started

----------------

::

    $ mishmash info

    /\/\_____  .__       .__        _____                .__   /\/\

    \(\(     \ |__| _____|  |__    /     \ _____    _____|  |__\(\(

      /  \ /  \|  |/  ___/  |  \  /  \ /  \\__  \  /  ___/  |  \

     /    Y    \  |\___ \|   Y  \/    Y    \/ __ \_\___ \|   Y  \

     \____|__  /__/____  >___|  /\____|__  (____  /____  >___|  /

             \/        \/     \/         \/     \/     \/     \/

    Version              : 0.3

    Database URL         : sqlite:////~/mishmash.db

    Database version     : 0.3

    Last sync            : Never

    Configuration files  : 

    === Music library ===

    0 music tracks

    0 music artists

    0 music albums

    0 music tags

Surprise, you now have an empty sqlite database in the current directory.

Let's leave it here for now, it can be located elsewhere or use a different

database using command line arguments and/or environment variables. Pretty

useless without any music.::

    $ mishmash sync ~/Music/Melvins

    Syncing library 'Music': paths=['~/Music/Melvins/']

    Syncing directory: ~/Music/Melvins/

    Syncing directory: ~/Music/Melvins/1984 - Mangled Demos

    Adding artist: Melvins

    Syncing directory: ~/Music/Melvins/1986 - 10 Songs

    Adding album: 10 Songs

    Adding track: ~/Music/Melvins/1986 - 10 Songs/Melvins - 01 - Easy As It Was.mp3

    Updating album: 10 Songs

    ...

    == Library 'Music' sync'd [ 8.73s time (45.9 files/s) ] ==

    401 files sync'd

    401 tracks added

    0 tracks modified

    0 orphaned tracks deleted

    0 orphaned artists deleted

    0 orphaned albums deleted

Use your database as you wish. Browse it with `mishmash web`, or use one of its

management commands.

Check out the `Unsonic`_ project for streaming capabilities.

.. _Unsonic: https://github.com/redshodan/unsonic

.. |Build Status| image:: https://travis-ci.org/nicfit/MishMash.svg?branch=master

   :target: https://travis-ci.org/nicfit/MishMash

   :alt: Build Status

.. |PyPI| image:: https://img.shields.io/pypi/v/MishMash.svg

   :target: https://pypi.python.org/pypi/MishMash/

   :alt: Latest Version

.. |Python versions| image:: https://img.shields.io/pypi/pyversions/MishMash.svg

   :target: https://pypi.python.org/pypi/MishMash/

   :alt: Supported Python versions

.. |License| image:: https://img.shields.io/pypi/l/MishMash.svg

   :target: https://pypi.python.org/pypi/MishMash/

   :alt: License

.. |Status| image:: https://img.shields.io/pypi/status/MishMash.svg

   :target: https://pypi.python.org/pypi/MishMash/

   :alt: Project Status

.. |Coverage| image:: https://coveralls.io/repos/nicfit/MishMash/badge.svg

   :target: https://coveralls.io/r/nicfit/MishMash

   :alt: Coverage Status