Skip to content

First Time Setup

Jump to bottom
Matteo Campinoti edited this page Jan 31, 2022 · 2 revisions

Here you will find instructions on how to set up an archive for the first time.

To start the program for the first time, run the init command in the folder you want your Fur Affinity archive to be located (you can use options or environment variables to operate on an archive in a different folder, see advanced usage for details).

falocalrepo init

The program will respond when the database is constructed and formatted, informing you of the specific database version it used.

Database initialised (version 5.0.10)

The next step is to set up the files folder and the cookies.

Files Folder

If you are okay with the database and files' folder being located in the same directory, skip to the next section.

To change the files' folder, use the config files-folder command.

# substitute $NEW_PATH with the new location of the files' folder relative to the database
falocalrepo config files-folder $NEW_PATH

If you want the files' folder to use an absolute path (for example if you want to keep the database and files on separate drives), add the --absolute argument to the command.

# substitute $NEW_PATH with the absolute location of the new files' folder
falocalrepo config files-folder $NEW_PATH --absolute

The program will confirm the new values, and copy any files present in an already existing folder to the new location. To avoid moving files, use the --no-move option.

Cookies

The cookies are used by the program together with the FAAPI library to fetch information from the Fur Affinity website.

You will need cookies from a login session. To find the cookies, open your browser's web developer tools (consult your browser guide for the correct way to do so), and locate the "storage" section (it may be called differently in your browser).

From here, copy the value (and only the value) of the a and b cookies.

To save the cookies in the database, use the config cookies command.

# substitute $COOKIE_A and $COOKIE_B for the respective cookies' values
falocalrepo config cookies --cookie a '$COOKIE_A' --cookie b '$COOKIE_B'

The program will confirm that the cookies have been saved and will prompt you to run the download login command to check their validity.

Check Cookies' Validity

To check if the cookies you have saved are valid, use the download login command.

falocalrepo download login

The program will load the cookies from the database and attempt to fetch the name of the user the login cookies belong to (equivalent to navigating to the furaffinity.net/me).

If the cookies are valid, you will see your username being printed to screen. IF they are not valid a message will be printed to the screen.

With the cookies validated, it's time to move to the next step, downloading!

Clone this wiki locally