Skip to content

Commit a678fa3

Browse files
committed
More explicit details about creating AoC configuration files
1 parent 2afbe56 commit a678fa3

File tree

1 file changed

+32
-1
lines changed

1 file changed

+32
-1
lines changed

README.md

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,10 +47,23 @@ To interact directly with the Advent of Code platform (e.g., for downloading inp
4747

4848
#### `aoc_headers.json`
4949

50-
This file contains HTTP headers used for all requests made to the Advent of Code platform. These headers include metadata such as the User-Agent to identify the source of the request.
50+
This file contains HTTP headers used for all requests made to the Advent of Code platform. The most important header is the User-Agent, which helps identify your automated requests to the Advent of Code servers.
51+
52+
The User-Agent should follow this format:
53+
- Project name and version
54+
- URL to your project/GitHub repository (optional)
55+
- Your contact information (email or GitHub username)
5156

5257
Example content:
5358

59+
```json
60+
{
61+
"User-Agent": "AdventOfCodeHelper/1.0 ([email protected])"
62+
}
63+
```
64+
65+
OR
66+
5467
```json
5568
{
5669
"User-Agent": "AdventOfCodeHelper/1.0 (+https://example.com; [email protected])"
@@ -63,6 +76,24 @@ This ensures requests conform to the platform's API requirements and helps ident
6376

6477
This file stores the session token obtained from the Advent of Code website after logging into your account. It is required for authentication and allows access to personalized inputs and submission capabilities.
6578

79+
To obtain your session token:
80+
81+
1. Log into [Advent of Code](https://adventofcode.com)
82+
83+
2. Open your browser's Developer Tools:
84+
- Chrome/Edge: Press F12 or Ctrl+Shift+I
85+
- Firefox: Press F12 or Ctrl+Shift+I
86+
- Safari: Enable 'Show Develop menu in menu bar' in Preferences > Advanced, then press Cmd+Option+I
87+
88+
3. Navigate to:
89+
- Chrome/Edge: Application > Cookies > https://adventofcode.com
90+
- Firefox: Storage > Cookies
91+
- Safari: Storage > Cookies
92+
93+
4. Find the cookie named "session"
94+
95+
5. Copy its value into the `aoc_session` file
96+
6697
Example content:
6798

6899
```plaintext

0 commit comments

Comments
 (0)