{"id":22373878,"url":"https://github.com/ayltai/ansible-macos-preferences","last_synced_at":"2026-05-11T06:06:00.347Z","repository":{"id":39401865,"uuid":"283950150","full_name":"ayltai/ansible-macos-preferences","owner":"ayltai","description":"Applies macOS customizations","archived":false,"fork":false,"pushed_at":"2023-12-29T18:29:53.000Z","size":15,"stargazers_count":2,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-31T22:44:56.343Z","etag":null,"topics":["ansible","ansible-role","macos","preferences"],"latest_commit_sha":null,"homepage":"https://galaxy.ansible.com/ayltai/macos_preferences","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ayltai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-07-31T05:26:01.000Z","updated_at":"2023-01-16T01:19:15.000Z","dependencies_parsed_at":"2023-02-14T02:46:26.271Z","dependency_job_id":null,"html_url":"https://github.com/ayltai/ansible-macos-preferences","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayltai%2Fansible-macos-preferences","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayltai%2Fansible-macos-preferences/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayltai%2Fansible-macos-preferences/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayltai%2Fansible-macos-preferences/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ayltai","download_url":"https://codeload.github.com/ayltai/ansible-macos-preferences/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245700557,"owners_count":20658245,"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":["ansible","ansible-role","macos","preferences"],"created_at":"2024-12-04T21:15:05.134Z","updated_at":"2026-05-11T06:05:55.299Z","avatar_url":"https://github.com/ayltai.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# macOS customization role for Ansible\n\n[![GitHub workflow status](https://img.shields.io/github/workflow/status/ayltai/ansible-macos-preferences/CI?style=flat)](https://github.com/ayltai/ansible-macos-preferences/actions)\n[![Ansible quality score](https://img.shields.io/badge/quality-5-success)](https://galaxy.ansible.com/ayltai/macos_preferences)\n[![Ansible role](https://img.shields.io/badge/role-ayltai.macos_preferences-blue)](https://galaxy.ansible.com/ayltai/macos_preferences)\n![Maintenance](https://img.shields.io/maintenance/yes/2022?style=flat)\n[![Release](https://img.shields.io/github/release/ayltai/ansible-macos-preferences.svg?style=flat)](https://github.com/ayltai/ansible-macos-preferences/releases)\n[![License](https://img.shields.io/github/license/ayltai/ansible-macos-preferences.svg?style=flat)](https://github.com/ayltai/ansible-macos-preferences/blob/master/LICENSE)\n\nApplies macOS customizations.\n\n[![Buy me a coffee](https://img.shields.io/static/v1?label=Buy%20me%20a\u0026message=coffee\u0026color=important\u0026style=flat\u0026logo=buy-me-a-coffee\u0026logoColor=white)](https://buymeacoff.ee/ayltai)\n\n## Quick start\n\nMake sure you have [Homebrew](https://brew.sh) installed on macOS.\n\n### Installation\n```sh\nansible-galaxy install ayltai.macos_preferences\n```\n\n### Usage\n```yaml\n---\n- hosts: all\n  roles:\n    - ayltai.macos_preferences\n  vars:\n    macos_default_shell: bash\n```\n\n## Variables\n| Name | Type | Default | Description |\n|------|------|---------|-------------|\n| `macos_pause` | `integer` | 10 | Controls how long to wait before an information message is dismissed automatically. |\n| `macos_launchpad_grid_columns` | `integer` | 4 | Changes [Launchpad](https://support.apple.com/HT202635) layout to this many columns. |\n| `macos_launchpad_grid_rows` | `integer` | 3 | Changes [Launchpad](https://support.apple.com/HT202635) layout to this many rows. |\n| `macos_disable_disk_image_verification` | `boolean` | Yes | Disables disk image verification. |\n| `macos_disable_gate_keeper` | `boolean` | Yes | Disables [Gatekeeper](https://support.apple.com/HT202491)\n| `macos_disable_game_center` | `boolean` | Yes | Disables [Game Center](https://developer.apple.com/game-center). Requires [SIP](https://support.apple.com/HT204899) to be disabled. |\n| `macos_disable_smart_quotes` | `boolean` | Yes | Disables smart quotes feature. |\n| `macos_disable_smart_dashes` | `boolean` | Yes | Disables smart dashes feature. |\n| `macos_disable_sms` | `boolean` | Yes | Disables Sudden Motion Sensor. |\n| `macos_disable_hibernation` | `boolean` | Yes | Disables hibernation. Requires [SIP](https://support.apple.com/HT204899) to be disabled. |\n| `macos_disable_photos_auto_open` | `boolean` | Yes | Disables [Photos](https://www.apple.com/macos/photos) from opening automatically. |\n| `macos_ask_password_immediately` | `boolean` | Yes | Prompts for password immediately after screen is off or screensaver starts. |\n| `macos_enable_subpixel_font_rendering` | `boolean` | Yes | Enables sub-pixel rendering on external monitors. |\n| `macos_default_screenshot_format` | `string` | `png` | Sets the default image format for screenshots. Supports `jpg`, `tiff`, `gif`, `pdf` and `png`. |\n| `macos_default_screenshot_location` | `path` | `{{ macos_default_finder_location }}` | Sets the default location to save screenshots. |\n| `macos_default_finder_location` | `path` | `~/Downloads` | Sets the default location for new [Finder](https://support.apple.com/HT201732) windows. |\n| `macos_show_finder_file_extension` | `boolean` | Yes | Shows file extensions in [Finder](https://support.apple.com/HT201732). |\n| `macos_show_finder_status_bar` | `boolean` | Yes | Shows the status bar in [Finder](https://support.apple.com/HT201732). |\n| `macos_show_finder_quit` | `boolean` | Yes | Shows \"Quit\" menu item for [Finder](https://support.apple.com/HT201732). |\n| `macos_finder_sort_folder` | `boolean` | Yes | Shows folders on top when sorted by filename in [Finder](https://support.apple.com/HT201732). |\n| `macos_disable_file_extension_warning` | `boolean` | Yes | Disable the warning about file extension changes in [Finder](https://support.apple.com/HT201732). |\n| `macos_default_finder_view_style` | `string` | `Nlsv` | Sets the default view style in [Finder](https://support.apple.com/HT201732). Supports `Flwv` (cover flow view), `Nlsv` (list view), `clmv` (column view) and `icnv` (icon view). |\n| `macos_spring_loading_enabled` | `boolean` | Yes | Enables spring loading in [Finder](https://support.apple.com/HT201732). |\n| `macos_spring_loading_delay` | `integer` | 1 | Sets the spring loading delay in [Finder](https://support.apple.com/HT201732). |\n| `macos_disable_ds_store` | `boolean` | Yes | Disables the creation of `.DS_Store` files on network drives. |\n| `macos_disable_empty_trash_warning` | `boolean` | Yes | Disables the warning about emptying Trash. |\n| `macos_dock_position` | `string` | `right` | Sets the [Dock](https://support.apple.com/guide/macbook-air/apd4b7fb731f/mac) position. Supports `left`, `right` and `bottom`. |\n| `macos_dock_tile_size` | `integer` | 32 | Sets the [Dock](https://support.apple.com/guide/macbook-air/apd4b7fb731f/mac) size in pixels. |\n| `macos_dock_lock_size` | `boolean` | Yes | Disable manual resizing of the [Dock](https://support.apple.com/guide/macbook-air/apd4b7fb731f/mac). |\n| `macos_dock_spring_loading` | `boolean` |  Yes | Enables spring loading in the [Dock](https://support.apple.com/guide/macbook-air/apd4b7fb731f/mac). |\n| `macos_dock_hide_recent_apps` | `boolean` | Yes | Disables showing recent applications in the [Dock](https://support.apple.com/guide/macbook-air/apd4b7fb731f/mac). |\n| `macos_terminal_encoding_utf8` | `boolean` | Yes | Sets the default character encoding to UTF-8 in [Terminal](https://support.apple.com/guide/terminal/welcome/mac). |\n| `macos_default_terminal_theme` | `string` | `Pro` | Sets the default [Terminal](https://support.apple.com/guide/terminal/welcome/mac) theme. |\n| `macos_disable_chrome_swipe_navigation` | `boolean` | Yes | Disable swipe navigation in [Google Chrome](https://www.google.com/intl/en_us/chrome). |\n| `macos_disable_itunes_media_keys` | `boolean` | Yes | Disables [iTunes](https://www.apple.com/itunes) Media Keys. Requires [SIP](https://support.apple.com/HT204899) to be disabled. |\n| `macos_default_dark_mode` | `boolean` | Yes | Turns on [Dark Mode](https://support.apple.com/HT208976) by default. |\n| `macos_accent_color` | `integer` | -1 | Sets the accent color. Supports `nil` (blue), -1 (graphite), 0 (red), 1 (orange), 2 (yellow), 3 (green), 4 (blue), 5 (purple) and 6 (pink). |\n| `macos_highlight_color` | `string` | `0.847059 0.847059 0.862745` | Sets the highlight color. Supports RGB values ranging from 0 to 1 in format `R G B`. |\n| `macos_disable_shake_mouse` | `boolean` | Yes | Disables shaking mouse pointer to locate feature. |\n| `macos_display_sleep` | `integer` | 10 | Sets the idle time before the display goes off. Sets it to 0 to disable the display from going off. |\n| `macos_computer_sleep` | `integer` | 0 | Sets the idle time before the computer goes to sleep. Sets it to 0 to disable the computer from sleeping. |\n| `macos_disable_sleep` | `boolean` | Yes | Disables the computer from sleeping. This will in turn set `macos_computer_sleep` to 0. |\n| `macos_quit_always_saves_windows` | `boolean` | Yes | Saves windows when macOS restarts or shuts down. |\n| `macos_faster_time_machine_backup` | `boolean` | Yes | Enables faster [Time Machine](https://support.apple.com/HT201250) backup by disabling CPU throttling. |\n| `macos_disable_memory_compression` | `boolean` | Yes | Disable memory compression. Requires [SIP](https://support.apple.com/HT204899) to be disabled. |\n| `macos_disable_crash_report` | `boolean` | Yes | Disables crash reports. Requires [SIP](https://support.apple.com/HT204899) to be disabled. |\n| `macos_update_frequency` | `integer` | 1 | Sets the update frequency of macOS in number of days. |\n| `macos_default_shell` | `string` | `bash` | Sets the default shell. Supports `bash`, `fish`, `ksh`, `tcsh`, and `zsh`. |\n\n## License\n[MIT](https://github.com/ayltai/ansible-macos-preferences/blob/master/LICENSE)\n\n## References\n* [Ansible](https://www.ansible.com)\n* [Ansible Galaxy](https://galaxy.ansible.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fayltai%2Fansible-macos-preferences","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fayltai%2Fansible-macos-preferences","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fayltai%2Fansible-macos-preferences/lists"}