applecatalog


Nameapplecatalog JSON
Version 2.0.2 PyPI version JSON
download
home_page
SummaryAppleCatalog download agent
upload_time2023-09-27 19:13:55
maintainer
docs_urlNone
author
requires_python>=3.8
license
keywords apple download automations updates
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            [![Python application](https://github.com/doronz88/applecatalog/workflows/Python%20application/badge.svg)](https://github.com/doronz88/applecatalog/actions/workflows/python-app.yml "Python application action")
[![Pypi version](https://img.shields.io/pypi/v/applecatalog.svg)](https://pypi.org/project/applecatalog/ "PyPi package")

# Description

Simple library for automating downloads of updates from Apple's servers. Use this simply tool for downloads macOS
images, CommandLineTools, XProtect database and just everything you can think of :).

# Installation

You can either install using `pip`:

```shell
python3 -m pip install -U applecatalog
```

Or install locally from git:

```shell
git clone git@github.com:doronz88/applecatalog.git
cd applecatalog
python3 -m pip install -U -e .
```

# Usage

```
Usage: python -m applecatalog [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  date      last update date
  download  download a single product packages
  info      query info for a single product
  list      list all products
```

## Snippets

```shell
# List CommandLineTools
python3 -m applecatalog list -q | grep CLTools

# List macOS
python3 -m applecatalog list --macos

# Download single component (by given PRODUCT_ID)
python3 -m applecatalog download PRODUCT_ID /tmp

```

## Example output

```
➜  dev applecatalog products list
Product(id='031-17335', version='11.0.0.0', title='Photo Content Catalogs', date=datetime.datetime(2015, 2, 23, 18, 1, 41), basename='PhotoContentCatalogs.smd')
Product(id='031-17334', version='11.0.0.0', title='Photo Content Themes', date=datetime.datetime(2015, 2, 23, 18, 1, 41), basename='PhotoContentThemes.smd')
Product(id='031-18981', version='17.0.0.0', title='Photo Content Catalogs', date=datetime.datetime(2015, 3, 25, 17, 12, 1), basename='PhotoContentCatalogs.smd')
Product(id='091-76740', version='1.0.0.0', title='Noticeboard Removal Tool', date=datetime.datetime(2018, 4, 5, 17, 17, 49), basename='NRT.smd')
Product(id='041-91737', version='1.0', title='BootCamp', date=datetime.datetime(2019, 10, 9, 19, 40, 56), basename='BootCampESD.smd')
Product(id='041-91736', version='1.0', title='BootCamp', date=datetime.datetime(2019, 10, 9, 19, 43, 9), basename='BootCampESD.smd')
Product(id='041-88235', version='31.0.0.0', title='Photo Content Catalogs', date=datetime.datetime(2019, 10, 9, 21, 33, 35), basename='PhotoContentCatalogs.smd')
Product(id='041-88237', version='31.0.0.0', title='Photo Content Themes', date=datetime.datetime(2019, 10, 9, 21, 34, 21), basename='PhotoContentThemes.smd')
Product(id='041-88232', version='1.8', title='Mac mini EFI Firmware Update', date=datetime.datetime(2019, 10, 9, 21, 35, 34), basename='MacminiEFIUpdate1.8.smd')
Product(id='041-88233', version='3.7.2', title='Remote Desktop Admin Update', date=datetime.datetime(2019, 10, 9, 21, 37, 47), basename='RemoteDesktopAdmin372.smd')
Product(id='041-88177', version='2.0.1', title='Dictation Language Update - Italian (Italy)', date=datetime.datetime(2019, 10, 9, 23, 10, 48), basename='SRCLUpdate_it_IT.smd')
Product(id='041-94866', version='2.0.1', title='Dictation Language Update - English (Australia)', date=datetime.datetime(2019, 10, 9, 23, 11, 3), basename='SRCLUpdate_en_AU.smd')
Product(id='041-88170', version='2.0.3', title='Dictation Language Update - French (France)', date=datetime.datetime(2019, 10, 9, 23, 12, 27), basename='SRCLUpdate_fr_FR.smd')
Product(id='041-88171', version='2.0.1', title='Dictation Language Update - Spanish (United States)', date=datetime.datetime(2019, 10, 9, 23, 12, 28), basename='SRCLUpdate_es_US.smd')
Product(id='041-88172', version='2.0.1', title='Dictation Language Update - Chinese (China)', date=datetime.datetime(2019, 10, 9, 23, 12, 28), basename='SRCLUpdate_zh_CN.smd')
...
```

# Downloading macOS Images

Listing macOS images can be done as follows:

```
➜  apple-catalog git:(master) ✗ applecatalog products list --macos
MacOsProduct(product='061-26578', name=None, build='18F2059', version='10.14.5')
MacOsProduct(product='061-26589', name=None, build='18G103', version='10.14.6')
MacOsProduct(product='041-91758', name=None, build='17G66', version='10.13.6')
MacOsProduct(product='041-88800', name=None, build='18E2034', version='10.14.4')
MacOsProduct(product='041-90855', name=None, build='17F66a', version='10.13.5')
MacOsProduct(product='061-86291', name=None, build='19D2064', version='10.15.3')
MacOsProduct(product='001-04366', name=None, build='19E2269', version='10.15.4')
MacOsProduct(product='001-15219', name=None, build='19F2200', version='10.15.5')
MacOsProduct(product='001-36735', name=None, build='19G2006', version='10.15.6')
MacOsProduct(product='001-36801', name=None, build='19G2021', version='10.15.6')
MacOsProduct(product='001-51042', name=None, build='19H2', version='10.15.7')
MacOsProduct(product='001-57224', name=None, build='19H4', version='10.15.7')
MacOsProduct(product='001-68446', name=None, build='19H15', version='10.15.7')
MacOsProduct(product='071-14766', name='macOS Big Sur', build='20D91', version='11.2.3')
MacOsProduct(product='071-29172', name='macOS Big Sur', build='20E232', version='11.3')
MacOsProduct(product='071-32414', name='macOS Big Sur', build='20E241', version='11.3.1')
MacOsProduct(product='071-00696', name='macOS Big Sur', build='20F71', version='11.4')
MacOsProduct(product='071-52235', name='macOS Big Sur Beta', build='20G5042c', version='11.5')
MacOsProduct(product='071-59953', name='macOS Monterey beta', build='21A5268h', version='12.0')
```

For Downloading each one you just download their packages as you would for any other product:

```
➜  apple-catalog git:(master) ✗ applecatalog products download 071-59953 ~/Downloads/macos
2021-07-08 10:48:27 DoronZ.local root[21530] DEBUG downloading: UpdateBrain.zip
100%|██████████████████████████████████████████████████████████████████████████████████████████| 2.75M/2.75M [00:00<00:00, 44.7MiB/s]
2021-07-08 10:48:27 DoronZ.local root[21530] DEBUG downloading: Info.plist
...
```

For creating an installation from these files you can now simply:

```shell
sudo installer -pkg /path/to/InstallAssistant.pkg -target /
```

This should create an `Install macOS XXXXXX.app` application at your `/Applications` folder. If you wish to make a
bootable device from this installation you can use the following official guidelines:

https://support.apple.com/en-us/HT201372

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "applecatalog",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "doronz88 <doron88@gmail.com>",
    "keywords": "apple,download,automations,updates",
    "author": "",
    "author_email": "doronz88 <doron88@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/4b/6e/13c3192a401d64ac9d8d2b2ecaddd43ad7794becba83eee456e1c8855513/applecatalog-2.0.2.tar.gz",
    "platform": null,
    "description": "[![Python application](https://github.com/doronz88/applecatalog/workflows/Python%20application/badge.svg)](https://github.com/doronz88/applecatalog/actions/workflows/python-app.yml \"Python application action\")\n[![Pypi version](https://img.shields.io/pypi/v/applecatalog.svg)](https://pypi.org/project/applecatalog/ \"PyPi package\")\n\n# Description\n\nSimple library for automating downloads of updates from Apple's servers. Use this simply tool for downloads macOS\nimages, CommandLineTools, XProtect database and just everything you can think of :).\n\n# Installation\n\nYou can either install using `pip`:\n\n```shell\npython3 -m pip install -U applecatalog\n```\n\nOr install locally from git:\n\n```shell\ngit clone git@github.com:doronz88/applecatalog.git\ncd applecatalog\npython3 -m pip install -U -e .\n```\n\n# Usage\n\n```\nUsage: python -m applecatalog [OPTIONS] COMMAND [ARGS]...\n\nOptions:\n  --help  Show this message and exit.\n\nCommands:\n  date      last update date\n  download  download a single product packages\n  info      query info for a single product\n  list      list all products\n```\n\n## Snippets\n\n```shell\n# List CommandLineTools\npython3 -m applecatalog list -q | grep CLTools\n\n# List macOS\npython3 -m applecatalog list --macos\n\n# Download single component (by given PRODUCT_ID)\npython3 -m applecatalog download PRODUCT_ID /tmp\n\n```\n\n## Example output\n\n```\n\u279c  dev applecatalog products list\nProduct(id='031-17335', version='11.0.0.0', title='Photo Content Catalogs', date=datetime.datetime(2015, 2, 23, 18, 1, 41), basename='PhotoContentCatalogs.smd')\nProduct(id='031-17334', version='11.0.0.0', title='Photo Content Themes', date=datetime.datetime(2015, 2, 23, 18, 1, 41), basename='PhotoContentThemes.smd')\nProduct(id='031-18981', version='17.0.0.0', title='Photo Content Catalogs', date=datetime.datetime(2015, 3, 25, 17, 12, 1), basename='PhotoContentCatalogs.smd')\nProduct(id='091-76740', version='1.0.0.0', title='Noticeboard Removal Tool', date=datetime.datetime(2018, 4, 5, 17, 17, 49), basename='NRT.smd')\nProduct(id='041-91737', version='1.0', title='BootCamp', date=datetime.datetime(2019, 10, 9, 19, 40, 56), basename='BootCampESD.smd')\nProduct(id='041-91736', version='1.0', title='BootCamp', date=datetime.datetime(2019, 10, 9, 19, 43, 9), basename='BootCampESD.smd')\nProduct(id='041-88235', version='31.0.0.0', title='Photo Content Catalogs', date=datetime.datetime(2019, 10, 9, 21, 33, 35), basename='PhotoContentCatalogs.smd')\nProduct(id='041-88237', version='31.0.0.0', title='Photo Content Themes', date=datetime.datetime(2019, 10, 9, 21, 34, 21), basename='PhotoContentThemes.smd')\nProduct(id='041-88232', version='1.8', title='Mac mini EFI Firmware Update', date=datetime.datetime(2019, 10, 9, 21, 35, 34), basename='MacminiEFIUpdate1.8.smd')\nProduct(id='041-88233', version='3.7.2', title='Remote Desktop Admin Update', date=datetime.datetime(2019, 10, 9, 21, 37, 47), basename='RemoteDesktopAdmin372.smd')\nProduct(id='041-88177', version='2.0.1', title='Dictation Language Update - Italian (Italy)', date=datetime.datetime(2019, 10, 9, 23, 10, 48), basename='SRCLUpdate_it_IT.smd')\nProduct(id='041-94866', version='2.0.1', title='Dictation Language Update - English (Australia)', date=datetime.datetime(2019, 10, 9, 23, 11, 3), basename='SRCLUpdate_en_AU.smd')\nProduct(id='041-88170', version='2.0.3', title='Dictation Language Update - French (France)', date=datetime.datetime(2019, 10, 9, 23, 12, 27), basename='SRCLUpdate_fr_FR.smd')\nProduct(id='041-88171', version='2.0.1', title='Dictation Language Update - Spanish (United States)', date=datetime.datetime(2019, 10, 9, 23, 12, 28), basename='SRCLUpdate_es_US.smd')\nProduct(id='041-88172', version='2.0.1', title='Dictation Language Update - Chinese (China)', date=datetime.datetime(2019, 10, 9, 23, 12, 28), basename='SRCLUpdate_zh_CN.smd')\n...\n```\n\n# Downloading macOS Images\n\nListing macOS images can be done as follows:\n\n```\n\u279c  apple-catalog git:(master) \u2717 applecatalog products list --macos\nMacOsProduct(product='061-26578', name=None, build='18F2059', version='10.14.5')\nMacOsProduct(product='061-26589', name=None, build='18G103', version='10.14.6')\nMacOsProduct(product='041-91758', name=None, build='17G66', version='10.13.6')\nMacOsProduct(product='041-88800', name=None, build='18E2034', version='10.14.4')\nMacOsProduct(product='041-90855', name=None, build='17F66a', version='10.13.5')\nMacOsProduct(product='061-86291', name=None, build='19D2064', version='10.15.3')\nMacOsProduct(product='001-04366', name=None, build='19E2269', version='10.15.4')\nMacOsProduct(product='001-15219', name=None, build='19F2200', version='10.15.5')\nMacOsProduct(product='001-36735', name=None, build='19G2006', version='10.15.6')\nMacOsProduct(product='001-36801', name=None, build='19G2021', version='10.15.6')\nMacOsProduct(product='001-51042', name=None, build='19H2', version='10.15.7')\nMacOsProduct(product='001-57224', name=None, build='19H4', version='10.15.7')\nMacOsProduct(product='001-68446', name=None, build='19H15', version='10.15.7')\nMacOsProduct(product='071-14766', name='macOS Big Sur', build='20D91', version='11.2.3')\nMacOsProduct(product='071-29172', name='macOS Big Sur', build='20E232', version='11.3')\nMacOsProduct(product='071-32414', name='macOS Big Sur', build='20E241', version='11.3.1')\nMacOsProduct(product='071-00696', name='macOS Big Sur', build='20F71', version='11.4')\nMacOsProduct(product='071-52235', name='macOS Big Sur Beta', build='20G5042c', version='11.5')\nMacOsProduct(product='071-59953', name='macOS Monterey beta', build='21A5268h', version='12.0')\n```\n\nFor Downloading each one you just download their packages as you would for any other product:\n\n```\n\u279c  apple-catalog git:(master) \u2717 applecatalog products download 071-59953 ~/Downloads/macos\n2021-07-08 10:48:27 DoronZ.local root[21530] DEBUG downloading: UpdateBrain.zip\n100%|\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 2.75M/2.75M [00:00<00:00, 44.7MiB/s]\n2021-07-08 10:48:27 DoronZ.local root[21530] DEBUG downloading: Info.plist\n...\n```\n\nFor creating an installation from these files you can now simply:\n\n```shell\nsudo installer -pkg /path/to/InstallAssistant.pkg -target /\n```\n\nThis should create an `Install macOS XXXXXX.app` application at your `/Applications` folder. If you wish to make a\nbootable device from this installation you can use the following official guidelines:\n\nhttps://support.apple.com/en-us/HT201372\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "AppleCatalog download agent",
    "version": "2.0.2",
    "project_urls": {
        "Bug Reports": "https://github.com/doronz88/applecatalog/issues",
        "Homepage": "https://github.com/doronz88/applecatalog"
    },
    "split_keywords": [
        "apple",
        "download",
        "automations",
        "updates"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b294969506c4bcb79a963aa5c21a9667367bcd17ff389dde6c73f50c5a573c2a",
                "md5": "13517aaf1ce475840587b44af307d93f",
                "sha256": "5a9c6bf426c9d026366e2d8db44816bfc0fb27ff43444e00ceb89542e9dad29f"
            },
            "downloads": -1,
            "filename": "applecatalog-2.0.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "13517aaf1ce475840587b44af307d93f",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 6307,
            "upload_time": "2023-09-27T19:13:53",
            "upload_time_iso_8601": "2023-09-27T19:13:53.691257Z",
            "url": "https://files.pythonhosted.org/packages/b2/94/969506c4bcb79a963aa5c21a9667367bcd17ff389dde6c73f50c5a573c2a/applecatalog-2.0.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4b6e13c3192a401d64ac9d8d2b2ecaddd43ad7794becba83eee456e1c8855513",
                "md5": "01135ff544e5edac2b4c52fe4c0095ab",
                "sha256": "fbffbd0151c9d074cc51128e95bc14b9da4b0091d668b46ca2ade3d673ed9ab4"
            },
            "downloads": -1,
            "filename": "applecatalog-2.0.2.tar.gz",
            "has_sig": false,
            "md5_digest": "01135ff544e5edac2b4c52fe4c0095ab",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 5853,
            "upload_time": "2023-09-27T19:13:55",
            "upload_time_iso_8601": "2023-09-27T19:13:55.118017Z",
            "url": "https://files.pythonhosted.org/packages/4b/6e/13c3192a401d64ac9d8d2b2ecaddd43ad7794becba83eee456e1c8855513/applecatalog-2.0.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-09-27 19:13:55",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "doronz88",
    "github_project": "applecatalog",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "applecatalog"
}
Elapsed time: 0.11779s