{ "info": { "author": "Andrey Turbov", "author_email": "andrey.turbov@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "License :: Other/Proprietary License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python :: 3.5", "Topic :: Multimedia :: Sound/Audio", "Topic :: Utilities" ], "description": "What is OMF?\n============\nOrganize Media Files (OMF) is a command-line utility, which helps user to dispatch unsorted media files according meta data tags and configurable rules. OMF is using `Mutagen `_ to handle audio files. Later more media files support would be added.\n\nInstallation\n============\nUsing \\ *pip install*\\ \\: ::\n \n $ pip install organize_media_files\n\nGetting started\n===============\nAfter successfull installation, you can see OMF doing it's job by heading into \\ *example/*\\ , which is located in OMF top source tree directory. ::\n\n $ cd example/\n\nHere you can see `example.conf `_ and some sample audio files, containing filled metatags. Type: ::\n\n $ omf -d -c example.conf sample_mp3.mp3\n\n Moving:\n example/sample_mp3.mp3\n To:\n /tmp/omf_example/some_artist_mp3 - some_title_mp3\n\nYou can see OMF running in \\ ``--dry-run``\\ . It is designed to prevent unexpected behavior and to show user what is going to happen in specified configuration. Before rushing OMF usage, don't forget to set up proper configuration using .conf files.\n\nConfiguration files\n===================\nOMF providing sample \\ **system.conf**\\ and \\ **user.conf**\\ , both located at \\ */etc/.omfrc/*\\ directory. Configuration file's consist of two sections. \\ *[patterns]*\\ section is where user set's up dispatch path's - a \\ *pattern*\\ , which must be given in the form of absolute path's (\\'~\\' may be used to specify \\ *home*\\ directory) with inclusion of ``{metatags}``. \n\nExample audio file pattern in UNIX system\\: ::\n\n uno = ~/Music/{artist}/{tracknumber}-{title}\n\nValid ``{metatags}`` for audio file are: \\ ``{artist}``\\ , \\ ``{title}``\\ , \\ ``{album}``\\ , \\ ``{tracknumber}``\\ , \\ ``{genre}``\\ , \\ ``{date}``\\ , \\ ``{encoder}``\\ . Due to the simplicity of utility, OMF won't lexically analyze pattern's (except for valid \\ ``{metatags}``\\ ), so it is up to user to specify correct pattern (use \\ ``--dry-run``\\ option to see what's OMF going to do).\n\nUsage\n=====\nBasic OMF usage is: ::\n\n $ omf filename_1 filename_2 \n\nIn this case \\ ``filename_1``\\ and \\ ``filename_2``\\ will be dispatched according to the default pattern in \\ **user.conf**\\ .\n\nOptions:\n * \\ ``-h, --help``\\ - show help message.\n * \\ ``-d, --dry-run``\\ - run OMF without actually moving files and print verbose information.\n * \\ ``-c FILE, --config FILE``\\ - specify an alternative configuration file.\n * \\ ``-f, --force``\\ - ignore inconsistencies or/and overwrite files (for example, if a file, in a given list of filenames, with the same name already exists, overwrite it).\n * \\ ``-p PATTERN-NAME, --pattern PATTERN_NAME``\\ - explicitly specify dispatch pattern.\n\nTODO\n====\n1. Create documentation.\n2. Figure out how to move user.conf to home directory (got bug on it).\n3. Add bash-completion for patterns.\n4. Append extensions to the end of dispathed file.\n\nSome warnings for future\n========================\n1. OMF dispatching files using pathlib.Path(pattern-specified-path). Such behavior can lead to usage misunderstandings.", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/IsaacMother/organize-media-files", "keywords": "music collection pranizer", "license": "GPL-3", "maintainer": "", "maintainer_email": "", "name": "organize-media-files", "package_url": "https://pypi.org/project/organize-media-files/", "platform": "all", "project_url": "https://pypi.org/project/organize-media-files/", "project_urls": { "Homepage": "https://github.com/IsaacMother/organize-media-files" }, "release_url": "https://pypi.org/project/organize-media-files/1.0.1/", "requires_dist": null, "requires_python": "", "summary": "Organize Media Files", "version": "1.0.1" }, "last_serial": 2412403, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "2005c4eef66f958779c0af88113fff41", "sha256": "6c873950ae82d034e111e1640d45238155f76576dd9f027e541d4404b0941fd9" }, "downloads": -1, "filename": "organize-media-files-1.0.0.tar.gz", "has_sig": false, "md5_digest": "2005c4eef66f958779c0af88113fff41", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17039, "upload_time": "2016-10-19T20:58:34", "url": "https://files.pythonhosted.org/packages/81/bd/12093bde1de9cedbc8189b2982df596a18ebf712e81569e3cdd88df7f37f/organize-media-files-1.0.0.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "f9c9ef526663631a37f10e29f4feb844", "sha256": "1f0707ec0276ffa4cf0110c7597146980dc7426ece4ce64d859aec03e122d1ee" }, "downloads": -1, "filename": "organize-media-files-1.0.1.tar.gz", "has_sig": false, "md5_digest": "f9c9ef526663631a37f10e29f4feb844", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17018, "upload_time": "2016-10-20T08:30:05", "url": "https://files.pythonhosted.org/packages/e2/40/9e0b191399d73a5c9d9a05bcb9c5f06262693ca3a51ee8de7e8df43539bd/organize-media-files-1.0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "f9c9ef526663631a37f10e29f4feb844", "sha256": "1f0707ec0276ffa4cf0110c7597146980dc7426ece4ce64d859aec03e122d1ee" }, "downloads": -1, "filename": "organize-media-files-1.0.1.tar.gz", "has_sig": false, "md5_digest": "f9c9ef526663631a37f10e29f4feb844", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17018, "upload_time": "2016-10-20T08:30:05", "url": "https://files.pythonhosted.org/packages/e2/40/9e0b191399d73a5c9d9a05bcb9c5f06262693ca3a51ee8de7e8df43539bd/organize-media-files-1.0.1.tar.gz" } ] }