{"id":15574134,"url":"https://github.com/complexlogic/kmpc","last_synced_at":"2026-03-14T22:01:52.394Z","repository":{"id":112154689,"uuid":"552050099","full_name":"complexlogic/kmpc","owner":"complexlogic","description":"An M3U music playlist converter for Kodi","archived":false,"fork":false,"pushed_at":"2022-10-15T18:50:32.000Z","size":34,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-24T01:04:40.806Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/complexlogic.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":null,"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":"2022-10-15T17:47:45.000Z","updated_at":"2025-01-16T05:26:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"920f9383-112b-4549-88ae-ef9447c89e6a","html_url":"https://github.com/complexlogic/kmpc","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/complexlogic%2Fkmpc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/complexlogic%2Fkmpc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/complexlogic%2Fkmpc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/complexlogic%2Fkmpc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/complexlogic","download_url":"https://codeload.github.com/complexlogic/kmpc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250540948,"owners_count":21447427,"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-10-02T18:15:31.446Z","updated_at":"2026-03-14T22:01:47.359Z","avatar_url":"https://github.com/complexlogic.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kodi M3U Playlist Converter\nKodi M3U Playlist Converter (kmpc) is a desktop application that converts M3U music playlists for use in Kodi by changing file paths to Kodi music database URLs. This application is intended for Kodi users that create music playlists with a desktop music player, and want to export them to Kodi for listening in their living room setup.\n\n## Screenshot\n![kmpc_screenshot](https://user-images.githubusercontent.com/95071366/196001159-bd27eca0-52fb-458e-941c-aea5bd73e4b0.png)\n\n## Installation\nkmpc is compatible with Windows, macOS, and Linux.\n### Windows\nDownload the win64 zip file from the [latest release](https://github.com/complexlogic/kmpc/releases/latest) and extract its contents to a directory of your choice.\n\n### macOS\nThere is a Homebrew formula available for macOS users. Make sure you have the latest available Xcode installed, as well as Homebrew. Then, execute the following command:\n```\nbrew install complexlogic/tap/kmpc\n```\n### Linux\nThe Linux version is distributed as source only. See [Building](#building).\n\n## Usage\nkmpc converts your M3U music playlists by changing the file paths to Kodi database URLs. Database-based playlists provide better integration with Kodi than path-based playlists. However, this means that kmpc needs access your Kodi music database file. If you run Kodi on a different PC, you will need to either copy the database to the computer running kmpc, or share it via a network filesystem. As of v19 Matrix, the Kodi music database file is named `MyMusic82.db`.\n\nIt is important to ensure that every song in your input M3U playlists exists in your Kodi music database. If a single song from an input M3U playlist does not exist in the database, the conversion of that playlist will fail.\n\nkmpc assumes you have all of your M3U playlists contained in a single folder, which you can browse for in the settings. You also must set the path to the output folder, and the path to the Kodi music database file. \n\n#### Target System\nThis setting tells kmpc which system you're running Kodi on (not which system the playlists were created on). Set this to Windows if you're running Kodi on Windows, and Unix for all other platforms. This setting is needed so kmpc can convert path separators if necessary (e.g. \\ to / if you're going from Windows to Unix).\n\n#### File Extension\nThere are two types of M3U playlists: the default `.m3u` and the UTF-8 econded `.m3u8`. As of v19 Matrix, only `.m3u` is supported in Kodi, but `.m3u8` support is planned for v20 Nexus. The file extension setting can be used convert the file extension if necessary. However, this does not affect the encoding of the playlist contents.\n\n#### Path Replacement\nIf you run Kodi on a different system than the one the playlists were created on, you will likely need to do path replacement. This setting applies a text replacement for every path in your M3U playlists before looking it up in the database. For example, if you share your music via an NFS share:\n```\nInput:  /home/user/Music\nOutput: nfs://192.168.1.10/home/user/Music\n```\nIf you are unsure of the correct output path, you can use a graphical database viewer such as [Sqlite DB Browser](https://github.com/sqlitebrowser/sqlitebrowser) to check what Kodi has stored the path as, and update the kmpc path replacement output accordingly.\n\n## Building\nThe following dependencies are required to build kmpc:\n- Qt6 for Windows/Mac. The Linux version can use Qt5 or Qt6 but defaults to Qt5\n- fmt\n- sqlite3\n\n### Linux/Mac\nMake sure you have the dependencies installed.\n\n**Debian/Ubuntu**\n```\nsudo apt install qtbase5-dev libfmt-dev libsqlite3-dev\n```\n**Arch/Majaro**\n```\nsudo pacman -S qt5-base fmt sqlite\n```\n**Fedora**\n```\nsudo dnf install qt5-qtbase-devel fmt-devel sqlite-devel\n```\n**macOS (Homebrew)**\n```\nbrew install qt fmt sqlite\n```\n\nBuild with the following steps:\n```\ngit clone https://github.com/complexlogic/kmpc.git\ncd kmpc\nmkdir build \u0026\u0026 cd build\ncmake .. -DCMAKE_BUILD_TYPE=Release\nmake\nsudo make install\n```\nOn Linux, Qt5 will be used by default. If you want to use Qt6 instead, pass `-DUSE_QT6=ON` to cmake.\n\n### Windows\nThe Windows toolchain consists of Visual Studio and vcpkg in addition to Git and CMake. Before starting, make sure that Visual Studio is installed with C++ core desktop features and C++ CMake tools. The free Community Edition is sufficient.\n\nBuild with the following steps:\n```\ngit clone https://github.com/complexlogic/kmpc.git\ncd kmpc\nmkdir build\ncd build\ngit clone https://github.com/microsoft/vcpkg\ncmake .. -DCMAKE_TOOLCHAIN_FILE=\".\\vcpkg\\scripts\\buildsystems\\vcpkg.cmake\" -DVCPKG_TARGET_TRIPLET=\"x64-windows\"\ncmake --build . --config Release\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcomplexlogic%2Fkmpc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcomplexlogic%2Fkmpc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcomplexlogic%2Fkmpc/lists"}