Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thewh1teagle/rookie
Load cookies from your web browsers
https://github.com/thewh1teagle/rookie
browser cookies rust winapi
Last synced: about 1 month ago
JSON representation
Load cookies from your web browsers
- Host: GitHub
- URL: https://github.com/thewh1teagle/rookie
- Owner: thewh1teagle
- License: mit
- Created: 2023-09-26T23:55:43.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-05-12T03:45:10.000Z (about 1 month ago)
- Last Synced: 2024-05-12T04:19:53.459Z (about 1 month ago)
- Topics: browser, cookies, rust, winapi
- Language: Rust
- Homepage: https://crates.io/crates/rookie
- Size: 1.49 MB
- Stars: 93
- Watchers: 1
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Lists
- awesome-rust - rookie
README
# rookie
[](https://pypi.org/project/rookiepy/)
[](https://pypi.org/project/rookiepy/)
[](https://www.npmjs.com/package/@rookie-rs/api)
[](https://crates.io/crates/rookie/)
[](https://github.com/thewh1teagle/rookie/blob/main/rookie-rs/MIT-LICENSE.txt)
Load cookies from any browser on any platform
## Features 🚀
- Available for `Rust`, `Python`, and `JavaScript`
- Ensures type safety (e.g., `TypeScript`, `Python` with type hints)
- Super Fast, Built with `Rust`
- Bypass `Chrome` restriction like file locking
- Read session cookies from `Chrome` based browsers! (requires admin rights on `Windows`)
- Wide browsers support
- Cross-platform support for `Windows`, `Linux`, and `macOS`
## Usage ⚙️
## Rust
```shell
cargo add rookie
```
Create `main.rs` with the following
```rust
use rookie::brave;
fn main() {
let domains = vec!["google.com"];
let cookies = brave(Some(domains)).unwrap();
for cookie in cookies {
println!("{:?}", cookie);
}
}
```
## Python
```shell
pip install rookiepy
```
And the usage it similar to Rust
```python
import rookiepy
cookies = rookiepy.firefox(["google.com"])
for cookie in cookies:
print(cookie['domain'], cookie['value'])
```
## JavaScript
```console
npm install @rookie-rs/api
```
```js
import { brave } from "@rookie-rs/api";
const cookies = brave();
for (const cookie of cookies) {
console.log(cookie);
}
```
## Examples 📋
`Rust` [examples/rust](examples/rust)
`Python` [examples/python](examples/python)
`JavaScript` [examples/javascript](examples/javascript)
## Docs 📘
`Rust`
- [docs/Rust.md](docs/Rust.md)
- [docs.rs/rookie](https://docs.rs/rookie)
`Python`
- [docs/Python.md](docs/Python.md)
`JavaScript`
- [docs/JavaScript.md](docs/JavaScript.md)
## CLI 💻
You can use rookie as a `CLI` tool which will decrypt the cookies and print it as `JSON`
See [cli](https://github.com/thewh1teagle/rookie/tree/main/cli) folder
## Contribute 🤝
So far the following platforms are supported:
- **Brave:** `Linux`, `macOS`, `Windows`
- **Cachy:** `Linux`
- **Chrome:** `Linux`, `macOS`, `Windows`
- **Chromium:** `Linux`, `macOS`, `Windows`
- **Edge:** `Linux`, `macOS`, `Windows`
- **Firefox:** `Linux`, `macOS`, `Windows`
- **Internet Explorer:** `Windows`
- **LibreWolf:** `Linux`, `macOS`, `Windows`
- **Opera:** `Linux`, `macOS`, `Windows`
- **Opera GX:** `macOS`, `Windows`
- **Safari:** `macOS`
- **Vivaldi:** `Linux`, `macOS`, `Windows`
You are welcome to contribute support for other browsers, or other platforms.
## Support new browsers 🌐
If you have a browser with which the library isn't working with, it may not have been added to the list of supported browsers configs. You can create a pull request (PR) or an issue with the path to the cookies file on your computer, and I will add it.
look at [src/windows/config.rs](https://github.com/thewh1teagle/rookie/blob/main/rookie-rs/src/windows/config.rs) to see what configurations is needed.
## Testing Dates (DD/MM/YY) 📅
| Browser | Linux | macOS | Windows |
| :-------- | :------: | :------: | :------: |
| Brave | 01/10/23 | 25/11/23 | 01/10/23 |
| Cachy | 04/06/24 | N/A | N/A |
| Chromium | 01/10/23 | 25/11/23 | 01/10/23 |
| Chrome | 01/10/23 | 25/11/23 | 16/03/24 |
| Edge | 01/10/23 | - | 01/10/23 |
| Firefox | 01/10/23 | 25/11/23 | 16/03/24 |
| IE | N/A | N/A | 01/10/23 |
| LibreWolf | 01/10/23 | 25/11/23 | 01/10/23 |
| Opera | 01/10/23 | - | 01/10/23 |
| Opera GX | N/A | - | 01/10/23 |
| Safari | N/A | 02/10/23 | N/A |
| Vivaldi | 01/10/23 | 25/11/23 | 01/10/23 |
## Credits 🙌
[github.com/borisbabic/browser_cookie3](https://github.com/borisbabic/browser_cookie3)