PHPackages colinodell/aoc-downloader - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. colinodell/aoc-downloader ActiveProject[Utility & Helpers](/categories/utility) colinodell/aoc-downloader ========================= Downloads Advent of Code puzzles and inputs v0.1.3(2y ago)1111MITPHPPHP ^7.4 || ^8.0 Since Nov 14Pushed 2y ago1 watchersCompare [ Source](https://github.com/colinodell/aoc-downloader)[ Packagist](https://packagist.org/packages/colinodell/aoc-downloader)[ Fund](https://www.colinodell.com/sponsor)[ Fund](https://www.paypal.me/colinpodell/10.00)[ RSS](/packages/colinodell-aoc-downloader/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (4)Dependencies (7)Versions (5)Used By (0) Advent of Code Downloader ========================= [](#advent-of-code-downloader) [![License](https://camo.githubusercontent.com/de062b139662be88d8dc9a2cd62e3a01c9ea72f6447cf1f5d8ff24107822a663/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f636f6c696e6f64656c6c2f616f632d646f776e6c6f616465723f7374796c653d666c61742d737175617265)](https://github.com/colinodell/aoc-downloader/blob/main/LICENSE.md)[![Supported PHP Versions](https://camo.githubusercontent.com/7af8f9d9cb6fa6c9a7b49d5d4884fd7d8c9ed8df9d1edc4243daa30777fa3305/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f636f6c696e6f64656c6c2f616f632d646f776e6c6f616465723f7374796c653d666c61742d737175617265)](https://packagist.org/packages/colinodell/aoc-downloader)[![Packagist Version](https://camo.githubusercontent.com/e742579a6e0a7a889974ed82ee96d33d5537197fadb17752fcac3c40bd29b497/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636f6c696e6f64656c6c2f616f632d646f776e6c6f616465723f7374796c653d666c61742d737175617265)](https://packagist.org/packages/colinodell/aoc-downloader)[![GitHub Workflow Status (branch)](https://camo.githubusercontent.com/de654e086800366ed93d4958a6dd73178c925e3c31df434be1909dcc3ddbeaf5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f636f6c696e6f64656c6c2f616f632d646f776e6c6f616465722f43492f6d61696e3f7374796c653d666c61742d737175617265)](https://github.com/colinodell/aoc-downloader/actions/workflows/ci.yml)[![Sponsor this project](https://camo.githubusercontent.com/2e662697b46a37233abdd7e45373397aab0bd5206336533151cdf42455d81048/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73706f6e736f72253230746869732532307061636b6167652d2545322539442541342d6666363962342e7376673f7374796c653d666c61742d737175617265)](https://github.com/sponsors/colinodell) Simple PHP-based utility to download all [Advent of Code](https://adventofcode.com/) puzzles and inputs locally. Requirements ------------ [](#requirements) This project requires PHP 7.4 or higher. Installation ------------ [](#installation) There are three ways to download and use this utility: ### Composer Dependency [](#composer-dependency) Using PHP for your AoC puzzles? You can include this as a dev dependency in your repository: ``` composer require --dev colinodell/aoc-downloader ``` ### Standalone PHAR [](#standalone-phar) Don't want to mix dependencies or prefer a single executable file? A pre-compiled PHAR is also available via the [Releases tab](https://github.com/colinodell/aoc-downloader/releases). Simply download the `.phar` file, make it executable, and run it. ### From Source [](#from-source) ``` git clone https://github.com/colinodell/aoc-downloader.git cd aoc-downloader composer update -o --no-dev ``` Usage ----- [](#usage) You'll need to log into [adventofcode.com](https://adventofcode.com/) and grab your `session` cookie using your browser's dev tools: [![](session-cookie.png)](session-cookie.png) You can then pass that as an argument to this utility: ``` Usage: ./bin/aoc-downloader [options] [--] Arguments: session_id Session ID (from the adventofcode.com `session` cookie Options: -o, --output=OUTPUT The directory to save the downloaded files [default: "./puzzles"] -y, --year=YEAR The year to download puzzles for (default is all years) -h, --help Display help for the given command. When no command is given display help for the ./bin/download.php command -q, --quiet Do not output any message -V, --version Display this application version --ansi|--no-ansi Force (or disable --no-ansi) ANSI output -n, --no-interaction Do not ask any interactive question -v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug ``` It will save both the puzzle test and input data locally: ``` puzzles/2020 ├── day01 │   ├── input.txt │   └── README.md ├── day02 │   ├── input.txt │   └── README.md ├── day03 │   ├── input.txt │   └── README.md ├── day04 │   ├── input.txt │   └── README.md ├── day05 │   ├── input.txt │   └── README.md ├── day06 │   ├── input.txt │   └── README.md ├── day07 │   ├── input.txt │   └── README.md ├── day08 │   ├── input.txt │   └── README.md ├── day09 │   ├── input.txt │   └── README.md ├── day10 │   ├── input.txt │   └── README.md ... ``` ### Health Score 23 — LowBetter than 27% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity8 Limited adoption so far Community10 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 93.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~249 days Total 4 Last Release 893d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/4325b62a6ad366c731c3120595d861469be50f9da88df3ea99752c30ff98c179?d=identicon)[colinodell](/maintainers/colinodell) --- Top Contributors [![colinodell](https://avatars.githubusercontent.com/u/202034?v=4)](https://github.com/colinodell "colinodell (14 commits)")[![flavioheleno](https://avatars.githubusercontent.com/u/471860?v=4)](https://github.com/flavioheleno "flavioheleno (1 commits)") --- Tags advent-of-codeaocphpaocadventofcodeadvent ### Embed Badge ![Health badge](/badges/colinodell-aoc-downloader/health.svg) ``` [![Health](https://phpackages.com/badges/colinodell-aoc-downloader/health.svg)](https://phpackages.com/packages/colinodell-aoc-downloader) ``` ### Alternatives [roach-php/core A complete web scraping toolkit for PHP 1.5k352.4k3](/packages/roach-php-core)[ec-cube/ec-cube EC-CUBE EC open platform. 78527.0k1](/packages/ec-cube-ec-cube)[shlinkio/shlink A self-hosted and PHP-based URL shortener application with CLI and REST interfaces 4.8k4.3k](/packages/shlinkio-shlink)[spatie/laravel-pjax A pjax middleware for Laravel 5 513371.8k11](/packages/spatie-laravel-pjax)[glhd/conveyor-belt 14797.0k](/packages/glhd-conveyor-belt)[open-dxp/opendxp Content & Product Management Framework (CMS/PIM) 7310.3k29](/packages/open-dxp-opendxp) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)