.ci | ||
deployment | ||
Server | ||
Server.xcodeproj | ||
.gitignore | ||
ffmpeg LICENSE.txt | ||
LICENSE | ||
README.md |
Jellyfin for macOS
Part of the Jellyfin Project
Jellyfin for macOS is a launcher/wrapper built in Swift.
Build Process
Getting Started
-
Clone or download this repository.
git clone https://github.com/jellyfin/jellyfin-mac-app.git
-
Create a second directory beside this repository, called
jellyfin-mac-app-resources
.mkdir jellyfin-mac-app-resources
-
Download Jellyfin, and extract it. Rename the folder to
jellyfin
and put it inside the resources folder. -
Download the correct version of FFmpeg. Extract it, and place
ffmpeg
andffprobe
in the root ofjellyfin-mac-app-resources
. -
Open
Server.xcodeproj
with Xcode, and build.
Directory Structure
The basic directory structure should look like this:
jellyfin-mac-app
├── LICENSE
├── Server
└── Server.xcodeproj
jellyfin-mac-app-resources/
├── ffmpeg
├── ffprobe
└── jellyfin
FFmpeg Download
It's recommended to use a static macOS build of FFmpeg, such as Zeranoe's Builds.
At the time of writing, please use ffmpeg-4.0.2-macos64-static.zip.
Troubleshooting
The project didn't build!
Please review the error inside Xcode. If a build failed, it is likely because the resources aren't in the right directory.
The project built, but Jellyfin didn't launch. Xcode shows an error.
Does the console inside Xcode show Error Domain=NSPOSIXErrorDomain Code=13 "Permission denied"
? If so, you need to fix your Jellyfin directory inside -resources
.
Does 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. Use Activity Monitor to find and quit any open Jellyfin process.
The project built, but Jellyfin didn't launch. There are no errors I can see.
This wrapper does not launch the Web UI automatically. This will eventually become a configurable option. In the meanwhile, you can use the Jellyfin icon in the menu bar to launch the Web UI.