how to install Okular viewer on macOS Big Sur, using M1/Apple Silicon/arm64

okular-appleSilicon.md

1. Install homebrew from https://brew.sh/ (follow the instructions there)
2. tap the https://invent.kde.org/packaging/homebrew-kde/ repo, brew tap kde-mac/kde https://invent.kde.org/packaging/homebrew-kde.git
3. brew edit okular, workaround now is to comment out or delete the line depends_on "chmlib" (won't compile on macos arm64 for now as of 2021-08-18), then save (if using vim you need to first press i to insert/type, when saving then <esc> then :wq then <enter>.
4. brew install okular, wait for stuff to compile and/or install
5. It may ask for keychain credentials (to sign the binaries? because of mac arm64 security policy https://eclecticlight.co/2021/01/26/when-you-dont-have-permission-to-run-an-app-on-an-m1-mac/)
6. $(brew --repo kde-mac/kde)/tools/do-caveats.sh
7. Now okular is in your $HOME/Applications/KDE folder, and will show up in Launchpad! You can view pdf, djvu, etc documents.

This is the error on QCA-qt5 I am getting.

Last 15 lines from /Users/xxxx/Library/Logs/Homebrew/kf5-kwallet/01.cmake:
  CMake did not find one.

  Could not find a package configuration file provided by "Qca-qt5" with any
  of the following names:

    Qca-qt5Config.cmake
    qca-qt5-config.cmake

  Add the installation prefix of "Qca-qt5" to CMAKE_PREFIX_PATH or set
  "Qca-qt5_DIR" to a directory containing one of the above files.  If
  "Qca-qt5" provides a separate development package or SDK, be sure it has
  been installed.


-- Configuring incomplete, errors occurred!

using the formula from before the commit solves the problem

Could you provide more detailed instructions on how I can use it?

Could you provide more detailed instructions on how I can use it?

I guess that one can introduce QCA before qt6 by the followings:

1. cd /opt/homebrew/Library/Taps/homebrew/homebrew-core/Formula/q
   (It depends on your environment.)

2. git log --oneline qca.rb

3. We will use 7b85965596e qca: update 2.3.7 bottle.

4. So, git checkout 7b85965596e qca.rb

5. brew install qca.rb and it's done.

By the way, kf5-kwallet (or kf5-kconfigwidgets, ki18n, kdoctools and so on) cannot be introduced after the update. They urged to use HEAD repository. I don't know what to do with it. The messages are as follows:

Installing in /opt/homebrew/Cellar/kf5-kconfigwidgets/5.111.0. Run /tmp/kf5-kconfigwidgets-20240301-71318-dufw2s/kconfigwidgets-5.111.0/build/prefix.sh to set the environment for KConfigWidgets.
-- Looking for GLIBC
-- Looking for GLIBC - not found
-- Performing Test _OFFT_IS_64BIT
-- Performing Test _OFFT_IS_64BIT - Success
-- Performing Test HAVE_DATE_TIME
-- Performing Test HAVE_DATE_TIME - Success
-- Performing Test BSYMBOLICFUNCTIONS_AVAILABLE
-- Performing Test BSYMBOLICFUNCTIONS_AVAILABLE - Failed
-- Could not set up the appstream test. appstreamcli is missing.
CMake Warning at CMakeLists.txt:54 (find_package):
By not providing "FindKF5DocTools.cmake" in CMAKE_MODULE_PATH this project
has asked CMake to find a package configuration file provided by
"KF5DocTools", but CMake did not find one.
Could not find a package configuration file provided by "KF5DocTools"
(requested version 5.111.0) with any of the following names:
KF5DocToolsConfig.cmake
kf5doctools-config.cmake
Add the installation prefix of "KF5DocTools" to CMAKE_PREFIX_PATH or set
"KF5DocTools_DIR" to a directory containing one of the above files. If
"KF5DocTools" provides a separate development package or SDK, be sure it
has been installed.
CMake Error at CMakeLists.txt:56 (find_package):
By not providing "FindKF5I18n.cmake" in CMAKE_MODULE_PATH this project has
asked CMake to find a package configuration file provided by "KF5I18n", but
CMake did not find one.
Could not find a package configuration file provided by "KF5I18n"
(requested version 5.111.0) with any of the following names:
KF5I18nConfig.cmake
kf5i18n-config.cmake
Add the installation prefix of "KF5I18n" to CMAKE_PREFIX_PATH or set
"KF5I18n_DIR" to a directory containing one of the above files. If
"KF5I18n" provides a separate development package or SDK, be sure it has
been installed.
-- Configuring incomplete, errors occurred!
HOMEBREW_VERSION: 4.2.10-75-g99baaf3
ORIGIN: https://github.com/Homebrew/brew
HEAD: 99baaf350d30075480597b901a6c73bad9e56bf4
Last commit: 3 hours ago
Core tap HEAD: b4f3ba0ad644069acb51a7adc02d26fd45e148a7
Core tap last commit: 6 hours ago
Core tap JSON: 01 Mar 08:10 UTC
Core cask tap JSON: 01 Mar 08:11 UTC
HOMEBREW_PREFIX: /opt/homebrew
HOMEBREW_CASK_OPTS: []
HOMEBREW_DISPLAY: /private/tmp/com.apple.launchd.bBk4Fb3U0f/org.xquartz:0
HOMEBREW_EDITOR: /opt/homebrew/bin/gedit
HOMEBREW_MAKE_JOBS: 8
HOMEBREW_NO_BOOTSNAP: set
HOMEBREW_SORBET_RUNTIME: set
Homebrew Ruby: 3.1.4 => /opt/homebrew/Library/Homebrew/vendor/portable-ruby/3.1.4/bin/ruby
CPU: octa-core 64-bit arm_firestorm_icestorm
Clang: 15.0.0 build 1500
Git: 2.39.3 => /Applications/Xcode.app/Contents/Developer/usr/bin/git
Curl: 8.1.2 => /usr/bin/curl
macOS: 13.5-arm64
CLT: 15.1.0.0.1.1700200546
Xcode: 15.2
Rosetta 2: false

I am getting these issues too.

By not providing "FindKF5I18n.cmake" in CMAKE_MODULE_PATH this project has
asked CMake to find a package configuration file provided by "KF5I18n", but
CMake did not find one.
Could not find a package configuration file provided by "KF5I18n"
(requested version 5.111.0) with any of the following names:
KF5I18nConfig.cmake
kf5i18n-config.cmake
Add the installation prefix of "KF5I18n" to CMAKE_PREFIX_PATH or set
"KF5I18n_DIR" to a directory containing one of the above files. If
"KF5I18n" provides a separate development package or SDK, be sure it has
been installed.

You guys having trouble tried installing without building? getting the pre built binaries? like in
brew install --cask okular

The cask option didn't work for me.

not working for me either.
I did many things to try and work this through. KF5I18n package seems to not be found when trying to install Okular... Like KF5I18n uses KF5, but the KF5I18n package in homebrew actually installs KF6I18n, which is Version 6.0.0 and I have a feeling that makes it harder to find when looking for the dependency while building with homebrew.

Could not find a package configuration file provided by "KF5I18n"
(requested version 5.111.0) with any of the following names:

KF5I18nConfig.cmake
kf5i18n-config.cmake

Add the installation prefix of "KF5I18n" to CMAKE_PREFIX_PATH or set
"KF5I18n_DIR" to a directory containing one of the above files. If
"KF5I18n" provides a separate development package or SDK, be sure it has
been installed.

Could not find a package configuration file provided by "KF5I18n" (requested version 5.111.0) with any of the following names:

KF5I18nConfig.cmake
kf5i18n-config.cmake

Add the installation prefix of "KF5I18n" to CMAKE_PREFIX_PATH or set "KF5I18n_DIR" to a directory containing one of the above files. If "KF5I18n" provides a separate development package or SDK, be sure it has been installed.

I'm getting this exact same error, including:

Warning: Unable to query GitHub for recent issues on the tap
Validation Failed: [{"message"=>"The listed users and repositories cannot be searched either because the resources do not exist or you do not have permission to view them.", "resource"=>"Search", "field"=>"q", "code"=>"invalid"}]

I have the same error with "KF5I18n". Unable to install at this time.

Exactly the same error:

Could not find a package configuration file provided by "KF5I18n"
(requested version 5.111.0) with any of the following names:

KF5I18nConfig.cmake
kf5i18n-config.cmake

Add the installation prefix of "KF5I18n" to CMAKE_PREFIX_PATH or set "KF5I18n_DIR" to a directory containing one of the above files. If "KF5I18n" provides a separate development package or SDK, be sure it has been installed.

-- Configuring incomplete, errors occurred!

Im having the same issue with KF5I18n, did anyone manage to figure that out?

thanks!

+1 on the same error with KF5I18n.

I think the only real way I’ve been able to install Okular on Mac was from precompiled binary located at this link:

https://apps.kde.org/okular/

Under “Nightly Installers”

Thank you, I did try searching for the precompiled binary, wasn't easy to find, the link works :)

This method works for me, but here was an error "okular" can’t be opened because Apple cannot check it for malicious software. Which I had to override.

I’m probably going to make a nix derivation for it sometime.
so I can install on mac too.

I’m probably going to make a nix derivation for it sometime. so I can install on mac too.

installs on macbook and works so far

But I cannot print PDF files...

I downgraded followings.

$ brew doctor

Uncommitted files:
M Formula/k/karchive.rb
M Formula/k/kdoctools.rb
M Formula/k/ki18n.rb
M Formula/q/qca.rb
M Formula/t/threadweaver.rb

karchive 5.111.0
kdoctools 5.111.0
ki18n 5.115.0
qca 2.3.7
threadweaver 5.115.0

kf5-kactivities.rb 5.111.0
kf5-kbookmarks.rb 5.102.0
kf5-kconfigwidgets.rb 5.102.0
kf5-khtml.rb 5.102.0
kf5-kio.rb 5.102.0
kf5-knotifications.rb 5.111.0
kf5-kparts.rb 5.102.0
kf5-kwallet.rb 5.102.0
kf5-kxmlgui.rb 5.102.0

Then, I could install okular 23.08.2. But the print preview is too small and I cannot print PDF files...

Is there someone help me?

I think it's the issue from KDE homebrew tab. I have the same issue for dolphin

I figured it out. It's working if you use my fork: https://github.com/JakkuSakura/homebrew-kde
It's because homebrew-kde is using KDE 5, but several libraries like ki18n and karchive in homebrew is updated to KDE 6.

I figured it out. It's working if you use my fork: https://github.com/JakkuSakura/homebrew-kde
It's because homebrew-kde is using KDE 5, but several libraries like ki18n and karchive in homebrew is updated to KDE 6.

Great. Can you get dolphin working?

I hit a C++ compile error https://bugs.gentoo.org/894346 and I couldn't afford more time to continue by replacing the source. I started to use ForkLift eventually.

There are reports that dolphin are working after compiling in their own ways. KDE also offers custom build tools but I didn't try them.

For those you get qt5 cmake errors that it's unable to pick specific libraries. qt@5 from brew is broken on newer versions probably brew changed the installation location. Use the following command to fix:
find -L /opt/homebrew/lib/cmake/ -name 'Qt5*.cmake' -exec sed -i '' 's|"\${CMAKE_CURRENT_LIST_DIR}/../../../"|/opt/homebrew/opt/qt5/|g' {} \;

The qt5 cmake errors cannot be removed. I tried to ln -s but in vain. I had troubles with the "brew tap" commands as well. Is it, brew tap jakkusakura/kde https://github.com/JakkuSakura/homebrew-kde.git --force-auto-update or so?

For qt5 cmake error, where did you install qt5? It's better if you check the error log. For me, it's something like /opt/homebrew/lib/cmake/Qt5Gui/Qt5GuiConfig.cmake contains get_filename_component(_qt5Gui_install_prefix ${CMAKE_CURRENT_LIST_DIR}/../../../ ABSOLUTE) but it's invalid.
For the brew tap, you need to

brew untap kde-mac/kde --force
brew tap kde-mac/kde https://github.com/JakkuSakura/homebrew-kde

Then it should be fine

/opt/homebrew/lib/cmake//Qt6BuildInternals/StandaloneTests/Qt5CompatTestsConfig.cmake is what is obtained by find -L /opt/homebrew/lib/cmake/ -name 'Qt5*.cmake'. It says

% cat /opt/homebrew/lib/cmake//Qt6BuildInternals/StandaloneTests/Qt5CompatTestsConfig.cmake
＃ Copyright (C) 2024 The Qt Company Ltd.
＃ SPDX-License-Identifier: BSD-3-Clause

＃ TODO: Ideally this should look for each Qt module separately, with each module's specific version,
＃ bypassing the Qt6 Config file, aka find_package(Qt6SpecificFoo) repated x times. But it's not
＃ critical.
find_package(Qt6 6.8.2
COMPONENTS Core5Compat).

The qt5/6 is as follows:

lrwxr-xr-x 1 sakuraim admin 20 3 20 17:50 qt -> ../Cellar/qt/6.8.2_1
lrwxr-xr-x 1 sakuraim admin 24 3 21 04:47 qt5 -> ../Cellar/qt@5/5.15.16_1
lrwxr-xr-x 1 sakuraim admin 20 3 20 17:50 qt6 -> ../Cellar/qt/6.8.2_1
lrwxr-xr-x 1 sakuraim admin 24 3 21 04:41 qt@5 -> ../Cellar/qt@5/5.15.16_1
lrwxr-xr-x 1 sakuraim admin 20 3 20 17:50 qt@6 -> ../Cellar/qt/6.8.2_1

by % ls -la /opt/homebrew/opt/. The qt5 is introduced for 2c1970eb750 qt@5: update 5.15.16_1 bottle at /opt/homebrew/Library/Taps/homebrew/homebrew-core/Formula/q. I guess it is /opt/homebrew/Cellar/qt@5/5.15.16_1 since it says % brew uninstall --ignore-dependencies qt@5
Uninstalling /opt/homebrew/Cellar/qt@5/5.15.16_1... (10,849 files, 341.7MB)

ls says

% ls /opt/homebrew/Cellar/qt@5/5.15.16_1
Frameworks doc
INSTALL_RECEIPT.json include
LICENSE.FDL lib
LICENSE.GPL3-EXCEPT libexec
LICENSE.GPLv2 mkspecs
LICENSE.GPLv3 phrasebooks
LICENSE.LGPLv21 plugins
LICENSE.LGPLv3 qml
LICENSE.QT-LICENSE-AGREEMENT sbom.spdx.json
README share
bin translations

Hope it works.

Some progress:

$ brew link --force qt@5
$ sudo ln -s $(brew --prefix qt@5)/mkspecs /usr/local/mkspecs
$ sudo ln -s $(brew --prefix qt@5)/plugins /usr/local/plugins

Then, by your shell script, it works after ln -s /opt/homebrew/opt/qt@5 /opt/homebrew/opt/qt5. I could install kf5-ki18n.rb.

But, now another problem:

==> Installing kf5-kiconthemes from kde-mac/kde
==> cmake -G Ninja -B build -S . -D BUILD_QCH=ON -D BUILD_TESTING=ON -D BUILD_TE
Last 15 lines from /Users/sakuraim/Library/Logs/Homebrew/kf5-kiconthemes/01.cmake:
"KF5Archive", but CMake did not find one.
` Could not find a package configuration file provided by "KF5Archive"` ` (requested version 5.111.0) with any of the following names:`
KF5ArchiveConfig.cmake
kf5archive-config.cmake
` Add the installation prefix of "KF5Archive" to CMAKE_PREFIX_PATH or set` ` "KF5Archive_DIR" to a directory containing one of the above files. If` ` "KF5Archive" provides a separate development package or SDK, be sure it has` ` been installed.`
``
-- Configuring incomplete, errors occurred!

Some idea?

After brew install kf5-karchive.rb in your fork repository, it delivers some errors for phonon.

I bypassed the errors of phonon by editing the header files of enum to explicity use unsigned. It's like this: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=272029.

I think I managed to install okular, but I still cannot print PDF files in a just size. Thanks a lot!

Note that I also needed things including ln -s /opt/homebrew/lib/libKF5Archive.5.dylib /opt/homebrew/Cellar/kdoctools/5.109.0/bin/../../../../opt/karchive/lib/libKF5Archive.5.dylib.