{"id":16541526,"url":"https://github.com/thyrlian/macmanual","last_synced_at":"2025-10-28T14:31:59.883Z","repository":{"id":20882817,"uuid":"91167583","full_name":"thyrlian/MacManual","owner":"thyrlian","description":"Installation and Setup Guide","archived":false,"fork":false,"pushed_at":"2024-03-10T13:45:11.000Z","size":30887,"stargazers_count":14,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-05-01T21:29:54.090Z","etag":null,"topics":["application","applications","guide","installation","list","mac","macos","macosx","manual","osx","setup"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thyrlian.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-05-13T10:48:22.000Z","updated_at":"2024-03-01T06:36:46.000Z","dependencies_parsed_at":"2023-12-09T14:33:38.306Z","dependency_job_id":null,"html_url":"https://github.com/thyrlian/MacManual","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thyrlian%2FMacManual","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thyrlian%2FMacManual/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thyrlian%2FMacManual/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thyrlian%2FMacManual/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thyrlian","download_url":"https://codeload.github.com/thyrlian/MacManual/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219859382,"owners_count":16556036,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["application","applications","guide","installation","list","mac","macos","macosx","manual","osx","setup"],"created_at":"2024-10-11T18:55:15.605Z","updated_at":"2025-10-28T14:31:59.877Z","avatar_url":"https://github.com/thyrlian.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# MacManual\n\nInstallation and Setup Guide for Mac\n\n## Requirements\n\nBefore getting started, make sure you have a :apple::computer:.  If you don't have one yet, you could buy from [Apple Shop](https://www.apple.com/mac/) or awesome [eBay](http://www.ebay.com/) (for a better price).\n\n## Must-have Applications\n\n### Productivity\n\n| Price | App | Intro |\n| --- | --- | --- |\n| :free:* | [Alfred](https://www.alfredapp.com/) | An application launcher and productivity application, which boosts your efficiency with hotkeys, keywords and text expansion. |\n| :free: | [Hammerspoon](http://www.hammerspoon.org/) | A tool for powerful automation of OS X. |\n| :free: | [Ice](https://github.com/jordanbaird/Ice) | A powerful menu bar management tool. |\n| :euro: | [Bartender](https://www.macbartender.com/) | Lets you organize your menu bar apps, by hiding them, rearranging them, or moving them to the Bartender Bar. |\n| :free: | [Dozer](https://dozermac.com/) | Lets you hide menu bar items to give your Mac a cleaner look. |\n| :euro: | [ForkLift](http://www.binarynights.com/forklift/) | The most advanced dual pane file manager and file transfer client. |\n| :free: | [muCommander](http://www.mucommander.com/) | A cross-platform, lightweight, open-source file manager. |\n| :free: | [The Unarchiver](https://itunes.apple.com/us/app/the-unarchiver/id425424353?mt=12) | A small and easy to use program that can unarchive many different kinds of archive files. |\n| :free: / :euro: | [Keka](https://www.keka.io/) | A macOS file archiver, stores more, shares with privacy. |\n| :free: | [Spectacle](https://www.spectacleapp.com/) | Window control with simple and customizable keyboard shortcuts. |\n| :euro: | [Divvy](http://mizage.com/divvy/) | A utility to quickly resize and position your windows. |\n| :euro: | [Magnet](http://magnet.crowdcafe.com/) | Declutters your screen by snapping windows into organized tiles. |\n| :euro: | [Paste](http://pasteapp.me/) | Keeps track of everything you've ever copied and lets you access your clipboard history anytime across. |\n| :free: | [Clipy](https://clipy-app.com/) | A Clipboard extension app for macOS. |\n| :euro: | [Unclutter](https://unclutterapp.com/) | A new handy place on your desktop for storing notes, files and pasteboard clips. |\n| :euro: | [Fantastical](https://flexibits.com/fantastical) | A calendar app let you quickly create new events and reminders with natural language input and more. |\n| :free: | [Itsycal](https://www.mowglii.com/itsycal/) | A tiny menu bar calendar. |\n| :free:* | [Evernote](https://evernote.com/) | Collect, nurture, and share ideas across desktop and mobile platforms with it. |\n| :free:* | [Wunderlist](https://www.wunderlist.com/) | A simple todo list and task manager app that helps you get stuff done. |\n| :euro: | [OmniFocus](https://www.omnigroup.com/omnifocus) | A personal task manager designed to quickly capture your thoughts and allow you to store, manage, and process them into actionable to-do items. |\n| :euro: | [OmniGraffle](https://www.omnigroup.com/omnigraffle) | A diagramming and digital illustration application for creating beautiful, precise graphics. |\n| :euro: | [iA Writer](https://ia.net/writer) | A text editor removes distractions, giving you a calm, focused writing space. |\n| :free:* | [Obsidian](https://obsidian.md/) | A private and flexible writing app that adapts to the way you think. |\n| :free:* | [Instapaper](https://www.instapaper.com/) | Syncs the articles and videos you save so that you can read them anywhere and anytime you want, even offline. |\n| :free: | [Simplenote](https://simplenote.com/) | An easy way to keep notes, lists, ideas and more. Light, clean, and free. |\n| :euro: | [Texifier](https://www.texifier.com/mac) | An editor and a productivity tool for academic and professional writing in LaTeX. |\n| :free: | [Buttercup](https://buttercup.pw/) | The Password Manager You Deserve. |\n| :free:* | [1Password](https://itunes.apple.com/us/app/1password-password-manager-and-secure-wallet/id568903335?mt=8) | Put Passwords In Their Place. |\n| :euro: | [1Keyboard](https://itunes.apple.com/us/app/1keyboard/id766939888?mt=12) | Type on your iPhone, iPad or Apple TV using your Mac's keyboard. |\n| :free:* | [Dropbox](https://www.dropbox.com/) | Bring your photos, docs, and videos anywhere and keep your files safe. |\n| :euro:* | [PDF Expert](https://pdfexpert.com/) | Read, annotate and edit PDFs, change text and images. Fill forms and sign contracts like never before. |\n| :free: | [CheatSheet](https://www.mediaatelier.com/CheatSheet/) | Just hold the ⌘-Key a bit longer to get a list of all active short cuts of the current application. |\n| :free:* | [Anki](https://apps.ankiweb.net/) | A friendly and intelligent flash cards program which makes remembering things easy. |\n| :free: | [Amphetamine](https://itunes.apple.com/us/app/amphetamine/id937984704?mt=12) | The most awesome keep-awake utility ever created. |\n| :free: | [KeepingYouAwake](https://github.com/newmarcel/KeepingYouAwake) | A Caffeine clone, prevent your Mac from entering sleep mode. |\n| :free:* | [Memory Clean](https://itunes.apple.com/us/app/memory-clean-monitor-and-free-up-memory/id451444120?mt=12) | The ultimate app for optimizing your Mac's memory. |\n| :euro: | [SwitchResX](http://www.madrau.com/) | The most advanced tool lets you easily change your display resolution and adjust other monitor settings directly from your menu bar or by using the Contextual Menu. |\n| :euro: | [Duet](https://www.duetdisplay.com/) | Lets you use your iPad or iPhone as an external monitor. |\n\n### Utilities\n\n| Price | App | Intro |\n| --- | --- | --- |\n| :euro: | [ToothFairy](https://c-command.com/toothfairy/) | Connect AirPods (or other Bluetooth headphones) to your Mac with a single click or keypress. |\n| :free: | [Munki](https://www.munki.org/munki/) | A collection of open-source tools used to manage installation of software packages on macOS client machines. |\n| :free: | [Mounty for NTFS](http://enjoygineering.com/mounty/) | A tiny tool to re-mount write-protected NTFS volumes. |\n\n### Design Tools\n\n| Price | App | Intro |\n| --- | --- | --- |\n| :euro: | [Sketch](https://sketchapp.com/) | The ultimate tool for designing user interfaces, websites, and icons. |\n| :euro: | [Affinity Photo](https://affinity.serif.com/en-us/photo/) | The fastest, smoothest, most precise professional image editing software. |\n| :euro: | [IconJar](https://geticonjar.com/) | Stores all your icons in one place, just a click away, leaves digging through your design asset folders behind and lets you access your icons without the hassle. |\n| :free: | [GIF Brewery](https://gfycat.com/gifbrewery) | Gives everyone the power to create stunning GIFs from video files. |\n\n### Media\n\n| Price | App | Intro |\n| --- | --- | --- |\n| :euro: | [Xee](https://theunarchiver.com/xee) | An streamlined and convenient image viewer and browser. |\n| :free: | [VLC](http://www.videolan.org/vlc/download-macosx.html) | A free and open source cross-platform multimedia player and framework that plays most multimedia files. |\n| :free: | [IINA](https://github.com/lhc70000/iina) | The modern video player. |\n| :free: | [Kodi](https://kodi.tv/) | A free media player that is designed to look great on your big screen TV but is just as home on a small screen. |\n| :free:* | [Spotify](https://www.spotify.com/) | A digital music service that gives you access to millions of songs. |\n| :euro: | [Permute](https://software.charliemonroe.net/permute.php) | The easiest to use media converter with it's easy to use, no configuration, drag and drop interface, it will meet the needs to convert all your media files. |\n\n### Internet\n\n| Price | App | Intro |\n| --- | --- | --- |\n| :free: | [Chrome](https://www.google.com/chrome/) | A fast, secure, and free web browser built for the modern web. |\n| :free: | [Firefox](https://www.mozilla.org/en-US/firefox/products/) | A fast, private, secure, and compatible web browser. |\n\n### Social Networking\n\n| Price | App | Intro |\n| --- | --- | --- |\n| :euro: | [Airmail](http://airmailapp.com/) | A lightning Fast Mail Client for Mac. |\n| :free:* | [Sparrow](https://github.com/thyrlian/MacManual/blob/master/Archives/Sparrow-latest-1.6.4(1176).dmg?raw=true) | An email client, had been acquired by Google and was ceasing continued development. |\n| :euro: | [Tweetbot](https://tapbots.com/tweetbot/mac/) | An award-winning Twitter client. |\n| :free: | [YoruFukurou](https://itunes.apple.com/us/app/night-owl/id428834068?mt=12) | A powerful native Twitter client. |\n| :free:* | [Skype](https://www.skype.com/en/) | An instant messaging app that provides online text message and video chat services. |\n\n### Developer Tools\n\n| Price | App | Intro |\n| --- | --- | --- |\n| :free: | [Homebrew](https://brew.sh/) | The missing package manager. |\n| :free: | [RVM](https://rvm.io/) | Ruby Version Manager. |\n| :free: | [JDK](http://www.oracle.com/technetwork/java/javase/downloads/index.html) | Includes a complete JRE plus tools for developing, debugging, and monitoring Java applications. |\n| :free: | [iTerm2](https://www.iterm2.com/) | A replacement for Terminal and the successor to iTerm. |\n| :free: | [Oh My Zsh](https://github.com/robbyrussell/oh-my-zsh) | An open source, community-driven framework for managing your zsh configuration. |\n| :free: | [Powerlevel10k](https://github.com/romkatv/powerlevel10k) | The most awesome Powerline theme for ZSH around. |\n| :free: | [Alacritty](https://github.com/jwilm/alacritty) | A cross-platform, GPU-accelerated terminal emulator (the fastest in existence). |\n| :free: | [Hyper](https://github.com/zeit/hyper) | A terminal built on web technologies. |\n| :free: | [TextMate](https://macromates.com/) | A graphical text editor. |\n| :free: | [Atom](https://atom.io/) | A free and open-source text and source code editor. |\n| :euro: | [Sublime Text](https://www.sublimetext.com/) | A sophisticated text editor for code, markup and prose. |\n| :free: | [Fork](https://git-fork.com/) | A fast and friendly git client for Mac and Windows. |\n| :free: | [SourceTree](https://www.sourcetreeapp.com/) | A free Mercurial and Git Client. |\n| :euro: | [Tower](https://www.git-tower.com/mac/) | A beautiful, efficient, and powerful Git version control app. |\n| :euro: | [Kaleidoscope](http://www.kaleidoscopeapp.com/) | The world's most advanced Mac diff tool. |\n| :euro: | [Monodraw](https://monodraw.helftone.com/) | An ASCII art editor. |\n| :euro: | [Quiver](http://happenapps.com/#quiver) | A notebook built for programmers. |\n| :free: | [Docker](https://www.docker.com/) | An open platform for developers and sysadmins to build, ship, and run distributed applications. |\n| :free:* | [Dash](https://kapeli.com/dash) | Gives your Mac instant offline access to 150+ API documentation sets. |\n| :euro: | [Charles Proxy](https://www.charlesproxy.com/) | A proxy / monitor enables a developer to view all traffic between their machine and the Internet. |\n| :free: | [Postman](https://www.getpostman.com/) | The complete toolchain for API developers. |\n| :free: | [Cocoa Rest Client](http://mmattozzi.github.io/cocoa-rest-client/) | A free open source, native Apple OS X app for testing HTTP/REST endpoints. |\n| :free:* | [Insomnia](https://insomnia.rest/) | A powerful REST API Client with cookie management, environment variables, code generation, and authentication. |\n| :free: | [Xcode](https://developer.apple.com/download/) | An IDE containing a suite of software development tools for macOS, iOS, watchOS and tvOS. |\n| :free: | [Network Link Conditioner](https://developer.apple.com/download/more/?q=Additional%20Tools) | A tool to simulate various kinds of network environments. |\n| :euro: | [Reveal](https://revealapp.com/) | Advanced visualisations, comprehensive inspectors and the ability to modify applications on the fly. |\n| :free: | [Android Studio](https://developer.android.com/studio/index.html) | The Official IDE for Android. |\n| :free:* | [Genymotion](https://www.genymotion.com/) | The most powerful Android emulation platform for app developers \u0026 testers. |\n| :free: | [VirtualBox](https://www.virtualbox.org/wiki/Downloads) | A free and open-source hypervisor for x86 virtualization. |\n| :free:* | [IntelliJ IDEA](https://www.jetbrains.com/idea/) | A Java IDE. |\n| :free: | [Visual Studio Code](https://code.visualstudio.com/) | A code editor redefined and optimized for building and debugging modern web and cloud applications. |\n| :free: | [CCMenu](http://ccmenu.org/) | Displays the build status of projects on a continuous integration server as an item in the Mac's menu bar. |\n| :free: | [Etcher](https://www.balena.io/etcher/) | Burn images to SD cards \u0026 USB drives, safely and easily. |\n| :free: | [SD Memory Card Formatter](https://www.sdcard.org/downloads/formatter/sd-memory-card-formatter-for-mac-download/) | Formats SD Memory Card, SDHC Memory Card and SDXC Memory Card (respectively SD/SDHC/SDXC Cards) complying with the SD File System Specification created by the SD Association (SDA). |\n\n### Other Goodies\n\n| Price | App | Intro |\n| --- | --- | --- |\n| :free: | [Aerial](https://github.com/JohnCoates/Aerial) | Apple TV Aerial Screensaver for Mac. |\n| :free: | [Reeder 3](http://reederapp.com/mac/) | A RSS reader client. |\n| :free: | [calibre](https://calibre-ebook.com/) | A powerful and easy to use e-book manager. |\n\n**Note**:\n* :free: - free app \n* :euro: - paid app\n* :free:* - free app but with paid features\n\n## Homebrew Packages\n\n* tree\n* wget\n* node\n* [jq](https://jqlang.github.io/jq/)\n* webp\n* [monitorcontrol](https://github.com/MonitorControl/MonitorControl)\n* [axel](https://github.com/axel-download-accelerator/axel)\n* [imagemagick](https://imagemagick.org/)\n\n## dotfiles\n\n* [My dotfiles](https://github.com/thyrlian/dotfiles)\n* [Your unofficial guide to dotfiles on GitHub](https://dotfiles.github.io/)\n* [Mathias’s dotfiles](https://github.com/mathiasbynens/dotfiles)\n* [thoughtbot dotfiles](https://github.com/thoughtbot/dotfiles)\n* [Paul's dotfiles](https://github.com/paulirish/dotfiles)\n\n## Collection of Commands\n\n* Disable screenshot shadow\n\n  ```bash\n  defaults write com.apple.screencapture disable-shadow -bool true; killall SystemUIServer\n  ```\n\n* Set Preview's sidebar display default to **Thumbnails**\n\n  ```bash\n  defaults write com.apple.Preview PVPDFSuppressSidebarOnOpening -bool false\n  ```\n\n* Converting **SVG** to **PNG**:\n\n  ```bash\n  qlmanage -t -s WIDTH_IN_PIXEL -o . IMAGE_TO_BE_CONVERTED.SVG\n  ```\n\n* Joining pages from a a collection of **PDF** files into a single PDF file:\n\n  ```bash\n  /System/Library/Automator/Combine\\ PDF\\ Pages.action/Contents/Resources/join.py -o PATH/TO/YOUR/MERGED/FILE.pdf /PATH/TO/ORIGINAL/1.pdf /PATH/TO/ANOTHER/2.pdf /PATH/TO/A/WHOLE/DIR/*.pdf\n  ```\n\n* Downloading **m3u8** playlist with a bunch of **ts** files, and combining them into a single video file:\n\n  ```bash\n  ffmpeg -headers \"ANY_NECESSARY_HEADER\" -i \"M3U8_URL\" -bsf:a aac_adtstoasc -vcodec copy -c copy -crf 50 OUTPUT_FILE.MP4\n  ```\n\n* To remove the lock icon from a file attachment stored in **1Password**:\n\n  ```bash\n  filename=\"YOUR_FILENAME_HERE\" \u0026\u0026 sudo chflags nouchg \"$filename\" \u0026\u0026 ls -lO \"$filename\" \u0026\u0026 for attr in $(xattr \"$filename\"); do xattr -d \"$attr\" \"$filename\"; done\n  ```\n\n## How-To\n\n* Hiding Spotlight inside Bartender (on macOS Sierra)\n    * Reboot into Recovery Mode (hold ⌘+R when hearing the startup chime);\n    * Go to **Utilities** -\u003e **Terminal**, run command `csrutil disable`, then reboot;\n    * Hide Spotlight inside Bartender app;\n    * Reboot into Recovery Mode again;\n    * Go to **Utilities** -\u003e **Terminal**, run command `csrutil enable`, then reboot.\n\n* I don't wanna have the Music app from Apple.  Well, you can't delete or disable it, but try [noTunes](https://github.com/tombonez/noTunes).\n\n* Missing app icon on Dock, and failing to \"Check for updates\" (due to Gatekeeper Path Randomization on macOS Sierra)\n    * Run command: `xattr -dr com.apple.quarantine /Applications/Your.app`;\n    * Drag app back onto Dock;\n    * Reboot Mac.\n\n* Authorized Restart (to bypass FileVault 2 pre-boot login screen)\n    ```console\n    sudo fdesetup authrestart\n    ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthyrlian%2Fmacmanual","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthyrlian%2Fmacmanual","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthyrlian%2Fmacmanual/lists"}