Skip to main content

An easy-to-use CLI to export your steam market history to various formats

Project description

PyPI PyPI - Python Version Gitlab pipeline status GitLab issues GitLab merge requests GitLab


Logo

steam-market-history

An easy-to-use CLI to export your steam market history to various formats
View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

steam-market-history is a command line tool written in Python which allows you to extract your entire Steam Market History with all transaction (sales/purchases) in a CSV or HTML file.

Key features

  • Extract your entire Steam Market History with all transactions to a HTML, CSV or JSON file
  • Overview of all transactions on a user-friendly webpage with searchable and filterable results

Built With

(back to top)

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

  • Python >= 3.8

Installation

Pip (recommended):

pip install steam-market-history

Manual:

  1. Clone the repo
    git clone https://gitlab.com/sustineo/steam-market-history.git
    
  2. Install poetry (if not already installed)
    pip install poetry
    
  3. Install dependencies and start virtual environment
    poetry install && poetry shell
    

(back to top)

Usage

Currently, the following commands are supported:

export

Export your steam market history to an HTML, JSON or CSV file

When running the tool you will be prompted to insert your steam credentials. All processing is done locally on your computer. This package does not save your credentials in any way.

Options:

  • --csv - Export market transactions to csv file
  • --html - Export market transactions to html file
  • --json - Export market transactions to json file
  • --path - Output directory for all file based operations (default: current working directory)
  • --launch / --no-launch - Automatically open file(s) after export (default: --launch)
  • --cache / --no-cache - Create a file cache for all market transactions (default: --no-cache)
  • --interactive / --non-interactive - Interactive or non-interactive steam authentication [default: --interactive]

Examples:

Export your steam market history to a HTML file:

steam-market-history export --html

Export your steam market history to a CSV file in a specific directory:

steam-market-history export --csv --path /tmp/steam-market-history

version

Display detailed information about this package. This includes the version, the license and the authors.

steam-market-history version

(back to top)

Roadmap

  • Add options of verbosity

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Acknowledgments

(back to top)

Disclaimer:

The Steam Market History Exported is a community project and is not affiliated with Valve or Steam.

(back to top)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

steam_market_history-3.1.0.tar.gz (10.2 kB view hashes)

Uploaded Source

Built Distribution

steam_market_history-3.1.0-py3-none-any.whl (10.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page