From 43cc15d1b30327f11eef39c2e562cd1d5ccf24de Mon Sep 17 00:00:00 2001 From: Alexander Graf <17130992+aandergr@users.noreply.github.com> Date: Wed, 29 Jan 2025 08:09:38 +0100 Subject: [PATCH] Update paragraph explaining `--load-cookies` and `--cookiefile` --- docs/cli-options.rst | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/docs/cli-options.rst b/docs/cli-options.rst index ae1d6a3..4966999 100644 --- a/docs/cli-options.rst +++ b/docs/cli-options.rst @@ -208,22 +208,24 @@ Instead of :option:`--login`, it is possible to use .. option:: --load-cookies BROWSER-NAME, -b BROWSER-NAME - Use Instagram cookie in your browser to login. - This feature requires the `browser_cookie3 `__ library. - Compatible with :option:`--cookiefile` if you want to load cookies from browser profiles. - Incompatible with :option:`--login` due to potential username mismatch between user input and browser login. - Supported browsers: Arc, Brave, Chrome, Chromium, Edge, Firefox, LibreWolf, Opera, Opera_GX, Safari and Vivaldi. + Load Instagram session cookies from a browser instead of using Instaloader's own login mechanism. + This method requires the `browser_cookie3 `__ library. + By default, cookies are loaded from the browser's main profile, but you can specify a custom cookie file using :option:`--cookiefile`. - In subsequent runs, you can just use :option:`--login` to reuse the - same session, which is saved by Instaloader. + Since :option:`--load-cookies` and :option:`--login` are alternative ways to acquire a session, they cannot be used together when initially acquiring a session. + + Supported browsers: Arc, Brave, Chrome, Chromium, Edge, Firefox, LibreWolf, Opera, Opera_GX, Safari, and Vivaldi. + + Once logged in via browser cookies, Instaloader saves the session, allowing you to use :option:`--login` in subsequent runs. .. versionadded:: 4.11 .. option:: --cookiefile COOKIE-FILE, -B COOKIE-FILE - Cookie file path of a browser profile to load cookies from. + Specifies a cookie file path for :option:`--load-cookies` to load cookies from a particular browser profile. + This option must be used together with :option:`--load-cookies` and does not work on its own. - .. versionadded:: 4.11 + .. versionadded:: 4.11 .. option:: --sessionfile SESSIONFILE, -f SESSIONFILE