{"id":18276682,"url":"https://github.com/jellyfin/jellyfin-server-macos","last_synced_at":"2025-04-09T09:10:39.071Z","repository":{"id":36644389,"uuid":"195352685","full_name":"jellyfin/jellyfin-server-macos","owner":"jellyfin","description":"The menu bar app and package for Jellyfin Server on macOS.","archived":false,"fork":false,"pushed_at":"2024-10-22T13:04:47.000Z","size":5468,"stargazers_count":61,"open_issues_count":10,"forks_count":14,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-10-25T05:08:42.626Z","etag":null,"topics":["hacktoberfest","jellyfin","macos"],"latest_commit_sha":null,"homepage":"https://jellyfin.org","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jellyfin.png","metadata":{"funding":{"open_collective":"jellyfin"},"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":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-07-05T06:36:51.000Z","updated_at":"2024-10-22T13:04:52.000Z","dependencies_parsed_at":"2023-10-12T07:15:33.863Z","dependency_job_id":"5e1e271c-5089-42fe-a7a0-78a1ac8c381d","html_url":"https://github.com/jellyfin/jellyfin-server-macos","commit_stats":{"total_commits":109,"total_committers":10,"mean_commits":10.9,"dds":0.5412844036697247,"last_synced_commit":"1e7fbe736b1f99b6995cd0a597551f710fca786b"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jellyfin%2Fjellyfin-server-macos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jellyfin%2Fjellyfin-server-macos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jellyfin%2Fjellyfin-server-macos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jellyfin%2Fjellyfin-server-macos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jellyfin","download_url":"https://codeload.github.com/jellyfin/jellyfin-server-macos/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247128747,"owners_count":20888235,"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":["hacktoberfest","jellyfin","macos"],"created_at":"2024-11-05T12:16:54.766Z","updated_at":"2025-04-09T09:10:39.045Z","avatar_url":"https://github.com/jellyfin.png","language":"Swift","funding_links":["https://opencollective.com/jellyfin"],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eJellyfin for macOS\u003c/h1\u003e\n\u003ch3 align=\"center\"\u003ePart of the \u003ca href=\"https://jellyfin.org\"\u003eJellyfin Project\u003c/a\u003e\u003c/h3\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\n\u003cimg alt=\"Logo Banner\" src=\"https://raw.githubusercontent.com/jellyfin/jellyfin-ux/master/branding/SVG/banner-logo-solid.svg?sanitize=true\"/\u003e\n\u003cbr/\u003e\n\u003cbr/\u003e\n\u003ca href=\"https://github.com/jellyfin/jellyfin-server-macos/blob/master/LICENSE\"\u003e\n\u003cimg alt=\"MPL 2.0 License\" src=\"https://img.shields.io/github/license/jellyfin/jellyfin-server-macos.svg\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/jellyfin\"\u003e\n\u003cimg alt=\"Donate\" src=\"https://img.shields.io/opencollective/all/jellyfin.svg?label=backers\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://features.jellyfin.org\"\u003e\n\u003cimg alt=\"Submit Feature Requests\" src=\"https://img.shields.io/badge/fider-vote%20on%20features-success.svg\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://matrix.to/#/+jellyfin:matrix.org\"\u003e\n\u003cimg alt=\"Chat on Matrix\" src=\"https://img.shields.io/matrix/jellyfin:matrix.org.svg?logo=matrix\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.reddit.com/r/jellyfin\"\u003e\n\u003cimg alt=\"Join our Subreddit\" src=\"https://img.shields.io/badge/reddit-r%2Fjellyfin-%23FF5700.svg\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/jellyfin/jellyfin-server-macos/commits/master.atom\"\u003e\n\u003cimg alt=\"Commits RSS Feed\" src=\"https://img.shields.io/badge/rss-commits-ffa500?logo=rss\" /\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\nJellyfin for macOS is a launcher/wrapper built in Swift and Objective-C.\n\u003c/p\u003e\n\u003cbr/\u003e\n\n# Getting Started\nAre you looking to just run and setup Jellyfin on your macOS machine? Go to https://jellyfin.org/downloads and get the macOS stable release.\n\nDo you want to build Jellyfin's menu bar app/launcher for yourself? Read on!\n\n---\n\n## Compiling the Menu App\n### Requirements\n* [Xcode for macOS](https://developer.apple.com/xcode/)\n\n### Steps\n1. Clone or download this repository.\n   ```sh\n   git clone https://github.com/jellyfin/jellyfin-server-macos.git\n   ```\n2. Open `Jellyfin Server.xcodeproj` with Xcode. Update version number and build.\n3. Archive the app to a local directory.\n\n### Usage\nThe Menu app is designed to do three things:\n1. Start and Stop a pre-packaged Jellyfin in the background\n2. Open the Web UI\n3. Open the Log Folder\n4. Ensure that the Jellyfin binary is pointed to the packaged version of the web UI\n5. Ensure that a cache folder exists before launching the server\n\n\n## Building the Full Package\n### Requirements\n* The compiled menu bar app from above\n* The latest [Jellyfin macOS Combined](https://repo.jellyfin.org/releases/server/macos/versions/stable/combined/) package\n\nIf you choose to build Jellyfin server on your own, you will also require:\n* [FFmpeg](https://evermeet.cx/ffmpeg/) for macOS, or equivalent FFmpeg/FFprobe 4.4+.\n\n### Steps\n1. Ensure that a complete copy of Jellyfin Server is available in a folder. If using the combined package from above, proceed to the next step.\n    * If you are building Jellyfin from source, place a copy of `ffmpeg` in the same folder as the server binary. You need to add `ffmpeg` and `ffprobe` alongside `jellyfin`. Ensure that you also build `jellyfin-web`.\n    * If using a packaged version, take the `jellyfin-web` folder out of the folder with the server in it.\n2. Locate the .app that was built above. Right/Ctrl Click it and choose \"Show Package Contents\".\n3. Go inside the folder `Contents`, then `MacOS`. Place the Jellyfin server and FFmpeg files here. Make sure they are not in a subfolder of their own.\n4. Go up one level, and go to the `Resources` folder. Place the `jellyfin-web` folder here. The folder name must match.\n5. (Optional) If you want to sign the .app for distribution, see the [Deployment Instructions](https://github.com/jellyfin/jellyfin-server-macos/tree/master/deployment).\n\n## Uninstalling\n\nJellyfin Server uses the directory `~/Library/Application Support/jellyfin` to store necessary contents. After deleting `Jellyfin Server.app`, delete that directory for a full uninstallation.\n\n## Troubleshooting\n\n### The project didn't build!\n\nPlease review the error inside Xcode. If a build failed, it is likely because the resources aren't in the right directory.\n\n### The project built, but Jellyfin didn't launch. Xcode shows an error.\n\nThis is because Jellyfin needs to be placed in the app bundle so it can be launched. This is currently a manual process, which can be scripted for convenience.\n\nDoes the console show a `Failed to bind to address` message? You may already have a copy of Jellyfin running on your computer. This can happen if you did not shutdown a separate Jellyfin install, or if you clicked on \"Stop\" inside Xcode while running/debugging. Use Activity Monitor to find and quit any open Jellyfin process.\n\n### The project built, but Jellyfin didn't launch. There are no errors I can see.\n\nYou must manually open the web UI by clicking on the icon in the menu bar first.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjellyfin%2Fjellyfin-server-macos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjellyfin%2Fjellyfin-server-macos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjellyfin%2Fjellyfin-server-macos/lists"}