Skip to content

Auax/passax

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Passax

EDUCATIONAL PURPOSES ONLY

Python3 library that can retrieve Chrome-based browser's saved login info.


Websites

Requirements

  • secretstorage~=3.3.1
  • pywin32==302 (Only Windows)
  • pycryptodome==3.12.0

Notice that these libraries will be automatically installed through the setup.py file when using pip install passax.


Supported Systems

Passax v-1.10 now includes:

  • macOS (Only tried in Monterrey)
  • Windows (Only tried in Win-10)
  • Linux (Tried on Ubuntu / Kali Linux)

Usage

Notice that sometimes you might get a blank output, this can be because you had installed the browser you're trying to get data from, but the login data was erased. You can use the blank_file = False parameter not to save the file if it's blank.

Print to screen the login info from Chrome.

from passax.chrome import windows, browsers

# Change to chrome.ChromeLinux for Linux users.
# Change to chrome.ChromeMacOS for MacOS users.
# Chrome is a supported browser
win = windows.Chrome(browsers.Chrome, blank_passwords=False)  # Class instance
win.fetch()  # Get database paths and keys
win.retrieve_database()  # Get the data from the database
print(win.pretty_print())

Save data to a file.

from passax.chrome import windows, browsers

win = windows.Chrome(browsers.Chrome, blank_passwords=False)
win.fetch()
win.retrieve_database()
win.save("login_data.txt", blank_file=False, verbose=True)

Save login data from all supported browsers.

from passax.chrome import windows, browsers

for browser in browsers.available_browsers:
    win = windows.Chrome(browser, blank_passwords=False)  # Class instance
    win.fetch()  # Get database paths and keys
    win.retrieve_database()  # Get the data from the database
    win.save(f"{browser.base_name}_data.txt", blank_file=False, verbose=True)  # Save the file

Run in any supported OS.

import platform
import sys

from passax.chrome import browsers

if platform.system() == "Windows":
    from passax.chrome import windows as os

elif platform.system() == "Linux":
    from passax.chrome import linux as os

elif platform.system() == "Darwin":
    from passax.chrome import macos as os

else:
    print("No compatible system!")
    sys.exit(-1)  # Clean exit

for browser in browsers.available_browsers:
    passax_ = os.Chrome(browser, blank_passwords=False)  # Class instance
    passax_.fetch()  # Get database paths and keys
    passax_.retrieve_database()  # Get the data from the database
    passax_.save(f"{browser.base_name}_data.txt", blank_file=False, verbose=True)

To do

  • Add the test file back (removed because it needed a fix)
  • Maybe add other browsers not based on Chromium (Firefox, for example).

Contact

Any suggestions/problems contact me at [email protected]