decrypt_cookies/browser/
chromium.rs

1use std::path::PathBuf;
2
3use super::CACHE_PATH;
4
5pub trait ChromiumPath {
6    /// Suffix for browser data path
7    const BASE: &'static str;
8    /// Browser name for [`std::fmt::Display`]
9    const NAME: &'static str;
10    #[cfg(not(target_os = "windows"))]
11    /// Suffix for cookies data path (sqlite3 database)
12    const COOKIES: &str = "Default/Cookies";
13    #[cfg(target_os = "windows")]
14    /// Suffix for cookies data path (sqlite3 database)
15    const COOKIES: &str = r"Default\Network\Cookies";
16    /// Suffix for login data path (sqlite3 database)
17    const LOGIN_DATA: &str = "Default/Login Data";
18    /// Another login data (sqlite3)
19    const LOGIN_DATA_FOR_ACCOUNT: &str = "Default/Login Data For Account";
20    #[cfg(target_os = "windows")]
21    /// Suffix for decryption key path (json)
22    const KEY: &str = "Local State";
23    #[cfg(not(target_os = "windows"))]
24    /// Safe keyring Storage name
25    const SAFE_STORAGE: &str;
26    #[cfg(target_os = "macos")]
27    /// Safe keyring name
28    const SAFE_NAME: &str;
29
30    #[cfg(target_os = "windows")]
31    /// Decryption key path (json)
32    fn key(mut base: PathBuf) -> PathBuf {
33        push_exact!(base, Self::KEY);
34
35        base
36    }
37    #[cfg(target_os = "windows")]
38    /// Copy the decryption key file to a location to avoid conflicts with the browser over access to it.
39    fn key_temp() -> Option<PathBuf> {
40        push_temp!(cache, Self::KEY);
41
42        cache.into()
43    }
44
45    /// Cookies path (sqlite3 database)
46    fn cookies(mut base: PathBuf) -> PathBuf {
47        push_exact!(base, Self::COOKIES);
48
49        base
50    }
51    /// Copy the cookies file to a location to avoid conflicts with the browser over access to it.
52    fn cookies_temp() -> Option<PathBuf> {
53        push_temp!(cache, Self::COOKIES);
54
55        cache.into()
56    }
57
58    /// Login data file (sqlite3 database)
59    fn login_data(mut base: PathBuf) -> PathBuf {
60        push_exact!(base, Self::LOGIN_DATA);
61        base
62    }
63    /// Copy the Login data file to a location to avoid conflicts with the browser over access to it.
64    fn login_data_temp() -> Option<PathBuf> {
65        push_temp!(cache, Self::LOGIN_DATA);
66
67        cache.into()
68    }
69
70    /// Login data file (sqlite3 database)
71    fn login_data_for_account(mut base: PathBuf) -> PathBuf {
72        push_exact!(base, Self::LOGIN_DATA_FOR_ACCOUNT);
73        base
74    }
75    /// Copy the Login data file to a location to avoid conflicts with the browser over access to it.
76    fn login_data_for_account_temp() -> Option<PathBuf> {
77        push_temp!(cache, Self::LOGIN_DATA_FOR_ACCOUNT);
78
79        cache.into()
80    }
81}
82
83/// Register a Chromium based browser info
84///
85/// It accept
86/// - `platform`
87/// - `browser`: Generate a struct
88/// - `base: <path>`: A browser all data location relative to home dir.
89/// - `cookies: <path>`, `login_data: <path>`, `login_data_fa: <path>`: Relative to base dir. (optional)
90/// - `key: <path>`: Relative to profile dir. Require on windows.
91/// - `safe_name: <name>`: Require on linux and macos
92///
93/// # Example:
94///
95/// ```rust, no_run
96/// chromium!(
97///     "linux",
98///     Chrome,
99///     base: ".config/google-chrome",
100///     cookies: "Default/Cookies",
101///     login_data: "Default/Login Data",
102///     login_data_fa: "Default/Login Data For Account",
103///     safe_name: "Chrome",
104/// );
105/// chromium!(
106///     "windows",
107///     Chrome,
108///     base: r"AppData\Local\Google\Chrome\User Data",
109///     cookies: r"Default\Network\Cookies",
110///     login_data: r"Default\Login Data",
111///     login_data_fa: r"Default\Login Data For Account",
112///     key: "Local State",
113/// );
114/// // or omit use default value
115/// chromium!("linux", Chrome, base: ".config/google-chrome", safe_name: "Chrome");
116/// chromium!("macos", Chrome, base: "Library/Application Support/Google/Chrome", safe_name: "Chrome");
117/// chromium!("windows", Chrome, base: r"AppData\Local\Google\Chrome\User Data");
118/// ```
119#[macro_export]
120macro_rules! chromium {
121    (
122        $platform:literal,
123        $browser:ident,
124        base: $base:literal
125        $(, cookies: $cookies:literal)?
126        $(, login_data: $login_data:literal)?
127        $(, login_data_fa: $login_data_fa:literal)?
128        $(, key: $key:literal)?
129        $(, safe_name: $safe_name:literal)?
130    ) => {
131        #[cfg(target_os = $platform)]
132        #[derive(Clone, Copy)]
133        #[derive(Debug)]
134        #[derive(Default)]
135        #[derive(PartialEq, Eq, PartialOrd, Ord)]
136        #[expect(clippy::exhaustive_structs, reason = "unit struct")]
137        pub struct $browser;
138
139        #[cfg(target_os = $platform)]
140        impl ChromiumPath for $browser {
141            const BASE: &'static str = $base;
142            const NAME: &'static str = stringify!($browser);
143            $(const COOKIES: &str = $cookies;)?
144            $(const LOGIN_DATA: &str = $login_data;)?
145            $(const LOGIN_DATA_FOR_ACCOUNT: &str = $login_data_fa;)?
146            $(const KEY: &str = $key;)?
147            $(
148                const SAFE_STORAGE: &str = const_format::concatcp!($safe_name, " Safe Storage");
149                #[cfg(target_os = "macos")]
150                const SAFE_NAME: &str = $safe_name;
151            )?
152        }
153
154        #[cfg(target_os = $platform)]
155        impl std::fmt::Display for $browser {
156            fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
157                f.write_str(Self::NAME)
158            }
159        }
160    };
161}
162
163chromium!("linux", Chrome  , base: ".config/google-chrome"              , safe_name: "Chrome"        );
164chromium!("linux", Edge    , base: ".config/microsoft-edge"             , safe_name: "Microsoft Edge");
165chromium!("linux", Chromium, base: ".config/chromium"                   , safe_name: "Chromium"      );
166chromium!("linux", Brave   , base: ".config/BraveSoftware/Brave-Browser", safe_name: "Brave"         );
167chromium!("linux", Vivaldi , base: ".config/vivaldi"                    , safe_name: "Vivaldi"       );
168chromium!("linux", Opera   , base: ".config/opera"                      , safe_name: "Opera"         );
169chromium!("linux", Yandex  , base: ".config/yandex-browser"             , login_data: "Default/Ya Passman Data", safe_name: "Yandex");
170
171macro_rules! cache_it {
172    ($($browser:ident,)*) => {
173        #[cfg(target_os = "linux")]
174        pub fn need_safe_storage(lab: &str) -> bool {
175            matches!(
176                lab,
177                $(| $browser::SAFE_STORAGE)*
178            )
179        }
180    };
181}
182cache_it!(Chrome, Edge, Chromium, Brave, Vivaldi, Opera, Yandex,);
183
184chromium!("macos", Chrome  , base: "Library/Application Support/Google/Chrome"              , safe_name: "Chrome"        );
185chromium!("macos", Edge    , base: "Library/Application Support/Microsoft Edge"             , safe_name: "Microsoft Edge");
186chromium!("macos", Chromium, base: "Library/Application Support/Chromium"                   , safe_name: "Chromium"      );
187chromium!("macos", Brave   , base: "Library/Application Support/BraveSoftware/Brave-Browser", safe_name: "Brave"         );
188chromium!("macos", Vivaldi , base: "Library/Application Support/Vivaldi"                    , safe_name: "Vivaldi"       );
189chromium!("macos", CocCoc  , base: "Library/Application Support/CocCoc/Browser"             , safe_name: "CocCoc"        );
190chromium!("macos", Arc     , base: "Library/Application Support/Arc/User Data"              , safe_name: "Arc"           );
191chromium!("macos", Opera   , base: "Library/Application Support/com.operasoftware.Opera"    , safe_name: "Opera"         );
192chromium!("macos", OperaGX , base: "Library/Application Support/com.operasoftware.OperaGX"  , cookies: "Cookies", login_data: "Login Data", safe_name: "Opera");
193chromium!("macos", Yandex  , base: "Library/Application Support/Yandex/YandexBrowser"       , login_data: "Default/Ya Passman Data", login_data_fa: "Default/Ya Passman Data", safe_name: "Yandex");
194
195chromium!("windows", Chrome  , base: r"AppData\Local\Google\Chrome\User Data"              );
196chromium!("windows", Edge    , base: r"AppData\Local\Microsoft\Edge\User Data"             );
197chromium!("windows", Chromium, base: r"AppData\Local\Chromium\User Data"                   );
198chromium!("windows", Brave   , base: r"AppData\Local\BraveSoftware\Brave-Browser\User Data");
199chromium!("windows", Vivaldi , base: r"AppData\Local\Vivaldi\User Data"                    );
200chromium!("windows", Opera   , base: r"AppData\Roaming\Opera Software\Opera Stable"        );
201chromium!("windows", OperaGX , base: r"AppData\Roaming\Opera Software\Opera GX Stable"     , cookies: r"Network\Cookies", login_data: r"Login Data", login_data_fa: r"Login Data For Account");
202chromium!("windows", CocCoc  , base: r"AppData\Local\CocCoc\Browser\User Data"             );
203chromium!("windows", Arc     , base: r"AppData\Local\Packages\TheBrowserCompany.Arc_ttt1ap7aakyb4\LocalCache\Local\Arc\User Data");
204chromium!("windows", Yandex  , base: r"AppData\Local\Yandex\YandexBrowser\User Data"       , login_data: r"Default\Ya Passman Data");
decrypt_cookies/browser/chromium.rs

decrypt_cookies/browser/
chromium.rs
