{"id":21004609,"url":"https://github.com/rangerrick/plex-itunes-import","last_synced_at":"2025-06-12T17:06:09.978Z","repository":{"id":66850421,"uuid":"78038976","full_name":"RangerRick/plex-itunes-import","owner":"RangerRick","description":"A tool for importing iTunes playlists into Plex.","archived":false,"fork":false,"pushed_at":"2018-03-22T20:51:14.000Z","size":40,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-13T14:23:23.098Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RangerRick.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-01-04T17:50:08.000Z","updated_at":"2021-02-26T00:01:24.000Z","dependencies_parsed_at":"2023-02-21T05:00:27.009Z","dependency_job_id":null,"html_url":"https://github.com/RangerRick/plex-itunes-import","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/RangerRick/plex-itunes-import","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RangerRick%2Fplex-itunes-import","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RangerRick%2Fplex-itunes-import/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RangerRick%2Fplex-itunes-import/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RangerRick%2Fplex-itunes-import/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RangerRick","download_url":"https://codeload.github.com/RangerRick/plex-itunes-import/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RangerRick%2Fplex-itunes-import/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259509381,"owners_count":22868832,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-19T08:36:57.829Z","updated_at":"2025-06-12T17:06:09.939Z","avatar_url":"https://github.com/RangerRick.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"iTunes Playlist Importer for Plex\n=================================\n\nThis project is a tool for importing an `iTunes Playlist.xml` file into Plex.  It assumes that the iTunes playlist and Plex are both using the same files, ie, they are both referencing music in the same directory or network share (most of the matching is based on the path/filenames matching).\n\n\nConfiguring the Importer\n------------------------\n\nCopy the `example.yaml` file to `config.yaml` and edit it to match your iTunes and Plex settings.\n\n\u003cdl\u003e\n  \u003cdt\u003e\u003cstrong\u003ehostname\u003c/strong\u003e\u003c/dt\u003e\n  \u003cdd\u003eThe hostname or IP address of your Plex server.\u003c/dd\u003e\n\n  \u003cdt\u003e\u003cstrong\u003eport\u003c/strong\u003e\u003c/dt\u003e\n  \u003cdd\u003eThe port that Plex is listening on.  (Optional)\u003c/dd\u003e\n\n  \u003cdt\u003e\u003cstrong\u003eusername\u003c/strong\u003e\u003c/dt\u003e\n  \u003cdd\u003eYour Plex username.\u003c/dd\u003e\n\n  \u003cdt\u003e\u003cstrong\u003epassword\u003c/strong\u003e\u003c/dt\u003e\n  \u003cdd\u003eYour Plex password.\u003c/dd\u003e\n\n  \u003cdt\u003e\u003cstrong\u003emanagedUser\u003c/strong\u003e\u003c/dt\u003e\n  \u003cdd\u003eIf you are using PlexHome users, set the \u003cstrong\u003ename\u003c/strong\u003e and \u003cstrong\u003epin\u003c/strong\u003e for the PlexHome user to operate as.\u003c/dd\u003e\n\n  \u003cdt\u003e\u003cstrong\u003eitunesxml\u003c/strong\u003e\u003c/dt\u003e\n  \u003cdd\u003eThe complete path to your \u003ccode\u003eiTunes Library.xml\u003c/code\u003e file.\u003c/dd\u003e\n\n  \u003cdt\u003e\u003cstrong\u003estripPrefixes\u003c/strong\u003e\u003c/dt\u003e\n  \u003cdd\u003eA list of prefixes to strip off of the beginning of file names when trying to determine song matches.\u003c/dd\u003e\n\n  \u003cdt\u003e\u003cstrong\u003estripNames\u003c/strong\u003e\u003c/dt\u003e\n  \u003cdd\u003eA list of regular expressions that are applied (in order, top to bottom) to album and song names when searching Plex for matches.\u003c/dd\u003e\n\u003c/dl\u003e\n\n\nRunning the Importer\n--------------------\n\nOnce you have checked out/downloaded the project, install the dependencies:\n\n`npm install`\n\nThen, you can run the importer with:\n\n`npm run import -- [--verbose] [--debug] [--config path/to/config.yaml]`\n\n\nTODO\n----\n\n* handle iTunes playlist changes (adding/removing songs)\n* handle deleting an iTunes playlist\n* be more efficient in requests (make a real cache that can track iTunes songs and Plex songs and avoid unnecessary queries)\n* GUI?","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frangerrick%2Fplex-itunes-import","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frangerrick%2Fplex-itunes-import","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frangerrick%2Fplex-itunes-import/lists"}