GitXplorerGitXplorer
g

FrontRow

public
43 stars
0 forks
2 issues

Commits

List of commits on branch main.
Unverified
ee4e2f8d7676736710c24c05ce934a3ed81c30d7

chore(deps): bump macOS build agent from 14 to 15

ggodly-devotion committed a month ago
Unverified
0c78a9afd4d04543783f8865a9e5a5551c3871d2

refactor: remove unnecessary code

ggodly-devotion committed a month ago
Unverified
ee718facc108d244051e3b5a22d3c550888e2df2

refactor: update window restoration code to official api

ggodly-devotion committed a month ago
Unverified
c38b003fb72f2c972c6facb3bc38f48ad87857d7

project: update required version to macOS 15.0

ggodly-devotion committed a month ago
Verified
e4d5aa8225a8be4624b69f4a351825687303612f

chore(deps): bump actions/checkout from 4.2.1 to 4.2.2 (#55)

ddependabot[bot] committed 3 months ago
Verified
7805cd4aa93a6a6ca33027fb5c2659b0a39cd220

chore(deps): bump actions/checkout from 4.2.0 to 4.2.1 (#54)

ddependabot[bot] committed 3 months ago

README

The README file for this repository.

Front Row

Play HDR videos & spatial audio natively

Screenshot

Experience color accurate HDR videos with full surround sound using spatial audio.

Download

Compatibility

Frequently Asked Questions

Why do I need this?

Many movies and TV shows are available with multichannel audio. However you would need to have a full surround sound setup in order to fully enjoy that experience. Apple introduced spatial audio which allows playing multichannel audio into regular headphones, such as the AirPods Pro. This vastly improves the roominess and depth of the played audio. Unfortunately, not many video players support Apple's spatial audio. So I created a simple video player with AVKit, which is able to use spatial audio.

What about just using QuickTime Player?

Sure, that works too. But I didn't like QuickTime Player's keyboard shortcuts nor its large on screen controls which blocks the video and subtitles.

Where is feature XYZ?

I created Front Row to play those rare video files that are in HDR and/or multichannel with spatial audio. For everything else, I use IINA like you.

Help! My video file is in MKV and doesn't open with Front Row

As Front Row is based on AVKit (which is what QuickTime Player uses), it can't directly open MKV files. However MKV is a container format and it usually contains Apple supported streams such as MPEG-4 video with AAC audio. If so, you can remux the file into an MP4 file using ffmpeg.

ffmpeg -i ./input.mkv -map 0 -c copy -tag:v hvc1 ./output.mp4

Note:

  • Add -c:s mov_text after -c copy if there are built in subtitles
  • Use -tag:v hvc1 for video streams encoded in H265. Use -tag:v avc1 instead for H264

I followed the steps above but don't hear any audio

The audio stream is in a codec that is not natively supported by Apple. You'll need to transcode the audio stream into a supported format.

ffmpeg -i ./input.mkv -map 0 -c copy -c:a aac_at -b:a 448k -tag:v hvc1 ./output.mp4

Note:

  • Add -c:s mov_text after -c copy if there are built in subtitles
  • Use -tag:v hvc1 for video streams encoded in H265. Use -tag:v avc1 instead for H264

I don't hear spatial audio through my supported device

First, make sure that the audio track contains more than 2 channels. Also, make sure to turn on spatial audio under the audio menu bar while the video is playing.