((META (EMPTY-STRING title "Enable Zettelstore to start automatically on macOS") (WORD role "manual") (TAG-SET tags ("#installation" "#manual" "#zettelstore")) (WORD syntax "zmk") (ZID-SET back ("00001003300000")) (ZID-SET backward ("00001003300000")) (NUMBER box-number "1") (STRING copyright "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (TIMESTAMP created "20220114181521") (ZID-SET forward ("00001003310104" "00001003310106" "00001003310108" "00001003310110" "00001004010000")) (WORD lang "en") (EMPTY-STRING license "EUPL-1.2-or-later") (TIMESTAMP modified "20220119124635") (TIMESTAMP published "20220119124635") (WORD visibility "public")) (BLOCK (PARA (TEXT "There are several ways to automatically start Zettelstore.")) (UNORDERED (INLINE (LINK-SELF () "#login-items" (TEXT "Login Items"))) (INLINE (LINK-SELF () "#launch-agent" (TEXT "Launch Agent")))) (HEADING 1 () "login-items" "login-items" (TEXT "Login Items")) (PARA (TEXT "Via macOS's system preferences, everybody is able to specify executables that are started when a user is logged in.") (SOFT) (TEXT "To do this, start system preferences and select ") (FORMAT-QUOTE () (TEXT "Users & Groups")) (TEXT ".")) (PARA (EMBED () (ZETTEL "00001003310104") "png" (TEXT "Zettel without title: 00001003310104"))) (PARA (TEXT "In the next screen, select the current user and then click on ") (FORMAT-QUOTE () (TEXT "Login Items")) (TEXT ".")) (PARA (EMBED () (ZETTEL "00001003310106") "png" (TEXT "Zettel without title: 00001003310106"))) (PARA (TEXT "Click on the plus sign at the bottom and select the Zettelstore executable.")) (PARA (EMBED () (ZETTEL "00001003310108") "png" (TEXT "Zettel without title: 00001003310108"))) (PARA (TEXT "Optionally select the ") (FORMAT-QUOTE () (TEXT "Hide")) (TEXT " check box.")) (PARA (EMBED () (ZETTEL "00001003310110") "png" (TEXT "Zettel without title: 00001003310110"))) (PARA (TEXT "The next time you log into your macOS computer, Zettelstore will be started automatically.")) (PARA (TEXT "Unfortunately, hiding the Zettelstore windows does not always work.") (SOFT) (TEXT "Therefore, this method is just a way to automate navigating to the directory where the Zettelstore executable is placed and to click on that icon.")) (PARA (TEXT "If you don't want the Zettelstore window, you should try the next method.")) (HEADING 1 () "launch-agent" "launch-agent" (TEXT "Launch Agent")) (PARA (TEXT "If you want to execute Zettelstore automatically and less visible, and if you know a little bit about working in the terminal application, then you could try to run Zettelstore under the control of the ") (LINK-EXTERNAL () "https://developer.apple.com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/Introduction.html" (TEXT "Launchd system")) (TEXT ".")) (PARA (TEXT "First, you have to create a description for ") (FORMAT-QUOTE () (TEXT "Launchd")) (TEXT ".") (SOFT) (TEXT "This is a text file named ") (LITERAL-INPUT () "zettelstore.plist") (TEXT " with the following content.") (SOFT) (TEXT "It assumes that you have copied the Zettelstore executable in a local folder called ") (LITERAL-INPUT () "~/bin") (TEXT " and have created a file for ") (LINK-ZETTEL () "00001004010000" (TEXT "startup configuration")) (TEXT " called ") (LITERAL-INPUT () "zettelstore.cfg") (TEXT ", which is placed in the same folder") (ENDNOTE () (TEXT "If you are not using a configuration file, just remove the lines ") (LITERAL-CODE () "<string>-c</string>") (TEXT " and ") (LITERAL-CODE () "<string>/Users/USERNAME/bin/zettelstore.cfg</string>") (TEXT ".")) (TEXT ":")) (VERBATIM-CODE () "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n\t<dict>\n\t\t<key>Label</key>\n\t\t<string>de.zettelstore</string>\n\n\t\t<key>ProgramArguments</key>\n\t\t<array>\n\t\t\t<string>/Users/USERNAME/bin/zettelstore</string>\n\t\t\t<string>run</string>\n\t\t\t<string>-c</string>\n\t\t\t<string>/Users/USERNAME/bin/zettelstore.cfg</string>\n\t\t</array>\n\n\t\t<key>WorkingDirectory</key>\n\t\t<string>/Users/USERNAME</string>\n\n\t\t<key>EnvironmentVariables</key>\n\t\t<dict>\n\t\t\t<key>HOME</key>\n\t\t\t<string>/Users/USERNAME</string>\n\t\t</dict>\n\n\t\t<key>KeepAlive</key>\n\t\t<true/>\n\n\t\t<key>LowPriorityIO</key>\n\t\t<true/>\n\n\t\t<key>ProcessType</key>\n\t\t<string>Background</string>\n\n\t\t<key>StandardOutPath</key>\n\t\t<string>/Users/USERNAME/Library/Logs/Zettelstore.log</string>\n\n\t\t<key>StandardErrorPath</key>\n\t\t<string>/Users/USERNAME/Library/Logs/Zettelstore-Errors.log</string>\n\t</dict>\n</plist>") (PARA (TEXT "You must substitute all occurrences of ") (LITERAL-INPUT () "USERNAME") (TEXT " with your user name.")) (PARA (TEXT "Place this file into the user specific folder ") (LITERAL-INPUT () "~/Library/LaunchAgents") (TEXT ".")) (PARA (TEXT "Log out and in again, or execute the command ") (LITERAL-CODE () "launchctl load ~/Library/LaunchAgents/zettelstore.plist") (TEXT "."))))