C Objective-C Shell C++ Java Python Other
Switch branches/tags
Nothing to show

README

OMO
---

To-do:

    Implement tag scraper.
    Add support for more formats.


Supported Formats
-----------------

OMO currently supports playing back files in these formats on all supported
platforms: MP3, MP2, MPG, MOD, S3M, XM, IT, 669, AMF, MTM, OKT, PSM, PTM, STM,
WAV, OGG, FLAC, AY, GBS, GYM, HES, KSS, NSF, SAP, SPC, VGM, and VGZ.

Additional support for these formats is available on MacOS: MP4, M4A, AAC, and
MID.

Additional support for these formats is available on Windows: MID.

Supported for more formats on all platforms will be added in the future.


Description
-----------

The goal of this project is to provide a way to organize and play back your
entire music collection. I grew up listening to music on a computer and have a
large collection of music in various formats. In the past I had used Winamp for
its extensive support for audio formats through input plugins.

Since moving away from Windows several years ago, I've not really had a good
way to play back a large portion of my music collection. I seek to change that
situation with OMO. That music disk I downloaded from a BBS 25 years ago will
live happily alongside that album I downloaded from Amazon last week.

OMO will leverage the power of the Internet to help you organize your
collection by pulling tags submitted by others. Tag your own untagged music and
submit those tags so others don't have to duplicate the work.


Installation
------------

MacOS: Open the DMG and drag the OMO application to the Applications folder.

Linux: Use dpkg -i <package_file>, then apt-get install -f.

Windows: Extract the ZIP file wherever you want and create a shortcut to
         omo.exe.


Getting Started
---------------

The first time you run OMO, you will be presented with a simple queue window.
You can add music to the queue by using the menu items, or the Open or Add
buttons in the queue window. When opening files, playback will automatically
begin. Use the playback buttons in the queue window to move between tracks,
pause, or stop playback.

To use the library features, you must first tell OMO where your music is
located. Use 'Library->Add Music Folder' and select a folder where OMO can find
your music files. You can add as many folders as you like and OMO will check
them all.

Once you have told OMO where to find your music, it will scan your music
collection. This process will be performed in the background so you can
continue to use OMO to play back your music files. The library scanning process
can take a long time if you have a large library. You can check the progress by
opening up the library view ('View->Library'). If you quit close OMO, it will
resume scanning your library next time you open it.

The library scanner will retrieve as much metadata on each file as it can find.
The tag sharing feature is not implemented yet, so tags cannot be retrieved
from online sources at this time.

Once you have set up a library folder, you can start tagging your music. To
open the tags editor, select a file in the song list pane in library view
(pane 3) or the queue list and press T.

Note: when using the library view, selecting All Artists or All Albums might
seem to freeze OMO if you have a large library. The list generation code has
not been optimized yet, so it can take a long time to generate the album and
song lists.


Contacting Us
-------------

E-Mail: todd@t3-i.com