A modern, platform-agnostic Flutter application for viewing and interacting with Shadowrun character files from the Chummer character creation application.
- 📱 Cross-Platform: Works on mobile, desktop, and web
- 📄 XML Parsing: Reads Chummer XML character files with comprehensive data extraction
- 🎨 Modern UI: Clean, intuitive Material Design interface
- 📊 Enhanced Character Display:
- Comprehensive attribute system with adept power modifiers
- Skills with skill groups and specializations
- Spells, spirits, and complex forms for magical characters
- Adept powers with ratings and effects
- Gear and equipment with categories and ratings
- Limit calculations and modifiers
- 🌙 Dark Mode: Automatic light/dark theme support
- 💾 File Handling: Easy file selection and caching
- 🔄 Backwards Compatibility: Supports both basic and enhanced parsing modes
- Character name, alias, metatype
- Physical characteristics (age, sex, height, weight)
- Karma, street cred, notoriety, public awareness
- All 8 primary attributes (Body, Agility, Reaction, Strength, Charisma, Intuition, Logic, Willpower)
- Special attributes (Edge, Magic, Resonance)
- Comprehensive skills system with skill groups
- Adept power modifications to attributes and skills
- Spells with categories and grades
- Spirits and their bindings
- Complex forms for technomancers
- Adept powers with ratings and specializations
- Weapons, armor, and general gear
- Equipment ratings and categories
- Equipped vs. carried status
- Quantity tracking
- Physical, Mental, and Social limits
- Initiative and other derived attributes
- Condition monitors (Physical and Stun damage)
This application supports the following platforms:
- ✅ Android - Full support
- ✅ Windows - Full support
- ✅ Linux - Full support
- ✅ Web - Full support
- ❌ iOS - Not supported
- ⏳ macOS - (See below)
Unfortunately, I will not be developing for iOS due to Apple's platform limitations. As this is a free, open-source application with no monetization, the costs and requirements associated with iOS development (Xcode requirements, Apple Developer Program fees, etc.) are not feasible for this project. I hope you understand this decision.
If there's sufficient community demand, I may consider adding macOS builds in the future, but these would be release-only builds without active development support.
MacOS users may encounter entitlement errors when running Chummer5X. This is because the app is not codesigned using an Apple Developer certificate. I'm not willing to pay for an Apple Developer license at this time. As such, this app is sandboxed on macOS and includes entitlements to access user-selected files:
- com.apple.security.app-sandbox = true
- com.apple.security.files.user-selected.read-write = true
- com.apple.security.files.bookmarks.app-scope = true (optional; for persisted access)
Users can:
- Right-click the app, choose "Open" and confirm on first run, or
- Remove quarantine attribute on the downloaded app:
xattr -dr com.apple.quarantine "/Applications/Chummer5X.app"
# or, before unzipping
yes | xattr -dr com.apple.quarantine ~/Downloads/Chummer5X-macos.zip- Flutter SDK (3.5.4 or later)
- Dart SDK
- Android Studio / VS Code with Flutter extensions
- Clone the repository:
git clone https://github.com/yourusername/chummer5x.git
cd chummer5x- Install dependencies:
flutter pub get- Run the application:
flutter run- Launch the application
- Tap "Load Character File" to select a Chummer XML file
- View your Shadowrun character's details, attributes, and stats
- Navigate through different character information screens
.chum5- Chummer5a files. This MAY work with legacy Chummer 5 files; I have not tested it. YMMV.
lib/
├── main.dart # Application entry point
├── models/
│ └── shadowrun_character.dart # Enhanced character data model with attributes, skills, magic, gear
├── screens/
│ ├── home_screen.dart # Main application screen
│ ├── character_detail_screen.dart # Character overview and navigation
│ └── skills_screen.dart # Skills, spells, powers, and gear display
├── services/
│ ├── chumer_xml_service.dart # Basic XML parsing (backwards compatible)
│ ├── enhanced_chumer_xml_service.dart # Comprehensive XML parsing
│ └── file_service.dart # File handling operations
└── widgets/
├── character_info_card.dart # Character information widget
└── attributes_card.dart # Enhanced attributes display widget
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Chummer team for the original character creation tool
- Shadowrun community for support and feedback
- Flutter team for the amazing framework