Difference between revisions of "Building MythFrontend on Mac OS X"
From MythTV Official Wiki
(Update to current state) |
|||
| (13 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | These instructions will walk you through setting up your Mac to compile and generate a Mythfrontend.app and .dmg file for | + | These instructions will walk you through setting up your Mac to compile and generate a Mythfrontend.app and .dmg file for macOS. |
= Building Mythfrontend with Macports and Ansible = | = Building Mythfrontend with Macports and Ansible = | ||
| − | {{Note box| | + | {{Note box|Most users should visit [[MythTV on Mac OS X]] to download prebuilt binaries. |
| − | |||
| − | |||
| − | |||
| − | |||
| − | == Install Xcode, Xcode Command Line Tools | + | == Install Xcode, Xcode Command Line Tools == |
| + | Xcode and Xcode Command Line Tools can now be installed via the Apple App Store. Please install them before moving on to installing the package manager of your choice (MacPorts or Homebrew). | ||
| − | == | + | == Install a Package Manager == |
| − | + | The compile script now works with either MacPorts or Homebrew. Please install your preferred package manager. | |
| + | === Option 1: Install MacPorts === | ||
| + | [https://www.macports.org MacPorts] | ||
| − | + | To install, follow the MacPorts' directions for installing MacPorts for your respective version of MacOS. | |
* [https://www.macports.org/install.php MacPorts installation instructions] | * [https://www.macports.org/install.php MacPorts installation instructions] | ||
{{Note box| Remember to run "sudo port -v selfupdate" after installing MacPorts to update the MacPorts repositories}} | {{Note box| Remember to run "sudo port -v selfupdate" after installing MacPorts to update the MacPorts repositories}} | ||
| − | == | + | === Option 2: Install Homebrew === |
| + | [https://brew.sh/ Homebrew] | ||
| − | + | == Download and Run the Compile Script == | |
| + | The compile script can be found in [https://github.com/MythTV/packaging/tree/master/macOS the official MythTV packaging repository] | ||
| − | + | Download "compileMythFrontendAnsible_cmake.zsh" to your system and make executable. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | == Run the Compile Script == | ||
| + | Run the script with the following command: | ||
{{Code box| bash or zsh| | {{Code box| bash or zsh| | ||
<pre> | <pre> | ||
| − | + | ./compileMythFrontendAnsible_cmake.zsh | |
</pre> | </pre> | ||
}} | }} | ||
| + | {{Note box| In order to install packages via ansible on macports, this script must be run by a user with sudo privileges. When prompted for either a "Password;" or "BECOME password:" you'll need to enter your sudo password.}} | ||
| − | + | The script automatically performs the following steps: | |
| + | # Sets up the build directory structure (tries to mirror the mythtv dev team's structure) | ||
| + | # Installs ansible-playbook via MacPorts o Homebrew | ||
| + | # Clones the MythTV ansible git repository | ||
| + | # Installs MythTV compile requirements and their dependencies via ansible and macports or homebrew) | ||
| + | # Clones the MythTV git repository, applying any user specified patches to mythtv or plugins | ||
| + | # Configures, builds, and installs MythTV and optionally MythPlugins | ||
| + | # Optionally generates and app bundle and distribution package for Mythfrontend.app | ||
= Pre-built Application = | = Pre-built Application = | ||
For those who would prefer to just download a pre-built application, these files can be found on the MythTVForMacOSX site. | For those who would prefer to just download a pre-built application, these files can be found on the MythTVForMacOSX site. | ||
| − | These files are updated sporadically by the | + | These files are updated sporadically by the github runners and the MythTV mac user community. |
* [https://sourceforge.net/projects/mythtvformacosx/files/ Download from Sourceforge] | * [https://sourceforge.net/projects/mythtvformacosx/files/ Download from Sourceforge] | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
= Problems? = | = Problems? = | ||
| − | If you have any problems | + | If you have any problems compiling mythtv, please post to the mythtv-users mailing list or [https://forum.mythtv.org/ mythtv forums]. |
| − | |||
| − | |||
| − | MacPorts | + | For MacPorts related issues, please post to the [https://lists.macosforge.org/mailman/listinfo/macports-users macports-users mailing list]. If necessary, please file a bug with the [http://guide.macports.org/#project.tickets MacPorts bug tracker]. |
| − | + | For Homebrew related issues, please consult the [https://docs.brew.sh/ Homebrew docs] and [https://github.com/orgs/Homebrew/discussions Homebrew discussions forum]. | |
[[Category:MacOS]] | [[Category:MacOS]] | ||
[[Category:MacPorts]] | [[Category:MacPorts]] | ||
| + | [[Category:Homebrew]] | ||
[[Category:Ansible]] | [[Category:Ansible]] | ||
[[Category:Distribution_Specific_Install_Guides]] | [[Category:Distribution_Specific_Install_Guides]] | ||
Latest revision as of 00:53, 10 February 2025
These instructions will walk you through setting up your Mac to compile and generate a Mythfrontend.app and .dmg file for macOS.
Contents
Building Mythfrontend with Macports and Ansible
{{Note box|Most users should visit MythTV on Mac OS X to download prebuilt binaries.
Install Xcode, Xcode Command Line Tools
Xcode and Xcode Command Line Tools can now be installed via the Apple App Store. Please install them before moving on to installing the package manager of your choice (MacPorts or Homebrew).
Install a Package Manager
The compile script now works with either MacPorts or Homebrew. Please install your preferred package manager.
Option 1: Install MacPorts
To install, follow the MacPorts' directions for installing MacPorts for your respective version of MacOS.
Note: Remember to run "sudo port -v selfupdate" after installing MacPorts to update the MacPorts repositories
Option 2: Install Homebrew
Download and Run the Compile Script
The compile script can be found in the official MythTV packaging repository
Download "compileMythFrontendAnsible_cmake.zsh" to your system and make executable.
Run the Compile Script
Run the script with the following command:
bash or zsh
./compileMythFrontendAnsible_cmake.zsh
Note: In order to install packages via ansible on macports, this script must be run by a user with sudo privileges. When prompted for either a "Password;" or "BECOME password:" you'll need to enter your sudo password.
The script automatically performs the following steps:
- Sets up the build directory structure (tries to mirror the mythtv dev team's structure)
- Installs ansible-playbook via MacPorts o Homebrew
- Clones the MythTV ansible git repository
- Installs MythTV compile requirements and their dependencies via ansible and macports or homebrew)
- Clones the MythTV git repository, applying any user specified patches to mythtv or plugins
- Configures, builds, and installs MythTV and optionally MythPlugins
- Optionally generates and app bundle and distribution package for Mythfrontend.app
Pre-built Application
For those who would prefer to just download a pre-built application, these files can be found on the MythTVForMacOSX site. These files are updated sporadically by the github runners and the MythTV mac user community.
Problems?
If you have any problems compiling mythtv, please post to the mythtv-users mailing list or mythtv forums.
For MacPorts related issues, please post to the macports-users mailing list. If necessary, please file a bug with the MacPorts bug tracker.
For Homebrew related issues, please consult the Homebrew docs and Homebrew discussions forum.
