A Python utility to download any Steam user's profile picture in the highest available resolution, with an optional AI-powered 4x upscaling feature.
- Project Status: This repository is no longer maintained. No further updates or bug fixes will be provided. Feel free to fork and modify it.
- Platform: This script has been tested and verified only on macOS. Compatibility with Windows or Linux is not guaranteed but likely.
- AI Requirements: Automatic installation of the AI upscaler (Real-ESRGAN) is only supported for macOS and Windows.
✨ Features
- Smart Search: Accepts Vanity IDs, SteamID64, or full Profile URLs.
- Bilingual Interface: Support for both Italian and English.
- AI Upscaling: Integrated with Real-ESRGAN to provide 4x resolution enhancement (realesrgan-x4plus model).
- Auto-Installer: Can automatically download and set up the necessary AI binaries if they are missing.
- Organized Saving: Avatars are automatically named after the user and saved to ~/Pictures/SteamAvatars.
🛠 Requirements
- Python 3.x.
- No external Python libraries are strictly required (uses standard libraries like urllib, html.parser, and subprocess).
- Real-ESRGAN (Optional): For the AI features. The script can attempt to install this for you.
🚀 How to Use
- Run the script: python3 steamavatardownloader.py
- Choose Language: Type it for Italian or en for English.
- AI Setup: When asked, decide if you want to enable AI upscaling. If you say yes and it's not found, the script will offer to download it for you.
- Enter Profile: Paste the Steam URL or ID of the target profile.
- Check Output: Your images will be waiting in your system's Pictures/SteamAvatars folder.
📝 Technical Details
- Scraping Logic: The script first tries to fetch data via Steam's XML interface (?xml=1) for the rawest image link. If that fails, it falls back to a custom HTML parser.
- Sanitization: Usernames are sanitized to ensure they are valid filenames on your OS.
- Upscaling: If enabled, the script runs a subprocess command to the Real-ESRGAN binary, applying the realesrgan-x4plus model to the downloaded file.
🌟 Credits & Acknowledgments
- This project is an advanced evolution of the original Steam-Avatar-Downloader by kouroshgz: https://github.com/kouroshgz/Steam-Avatar-Downloader. Special thanks to the original author for the foundational logic.
While the core idea of scraping Steam profile XML/HTML was inspired by the original script, I have significantly refactored and expanded the software to include:
- AI Super-Resolution: Integrated Real-ESRGAN (ncnn-vulkan) to provide high-quality 4x upscaling for downloaded avatars.
- Bilingual Interface: Added full support for both Italian and English users.
- Automated Dependency Management: Created a system to automatically detect, download, and configure the necessary AI binaries for macOS and Windows.
- Modern Python Refactoring: Updated the codebase to be compatible with Python 3.x standards, improved error handling, and implemented an organized file management system in ~/Pictures/SteamAvatars.
Parts of this code were refactored and enhanced using AI to ensure compatibility with modern Python standards and to integrate advanced features like Real-ESRGAN. This tool is for personal and educational use only. It is not affiliated with, authorized, or endorsed by Valve Corporation or Steam. Please respect the copyright of the original creators of the profile pictures.