# MarketSwimmer - Owner Earnings Analysis Tool 🏊♂️📈
A comprehensive Python tool for analyzing Warren Buffett's "Owner Earnings" from financial statement data, now with robust quarterly support, enhanced fair value calculation, and professional visualizations.
## 🚀 What's New in v2.5.2 (2025-08-16)
- **Accurate Quarterly Analysis:** Full quarter-by-quarter extraction and charting (no more Q1-only bug!)
- **Improved Fair Value DCF:** Enhanced scenario modeling and balance sheet adjustments
- **Cleaner Repo & Packaging:** Streamlined for PyPI, with automated cleanup and build scripts
- **GUI & CLI:** Modern PyQt6 GUI and powerful command-line interface
- **Professional Visualizations:** Multiple chart types, improved color schemes, and export options
## Key Features
- 📊 **Owner Earnings & DCF Analysis:** 10-year average, scenario-based, and per-share valuation
- 🗂️ **Automated Data Pipeline:** XLSX-to-CSV conversion, smart file detection, and logging
- 🖥️ **GUI & CLI:** Easy-to-use interface and full command-line support
- 📈 **Charts & Reports:** High-quality PNG charts and CSV exports for any ticker
- 🔍 **Open Source & Extensible:** MIT licensed, Python 3.8+, easy to extend
## Quick Start
```bash
pip install marketswimmer
marketswimmer gui
marketswimmer analyze TICKER
```
## 📦 **Installation**
```bash
pip install marketswimmer
```
## � Quick Start
### Command Line Usage
```bash
# Launch GUI
marketswimmer gui
# Process downloaded data
python process_financial_data.py TICKER
# Create visualizations
marketswimmer visualize --ticker TICKER
# Full analysis
marketswimmer analyze TICKER
```
### GUI Workflow
1. **Launch GUI**: `marketswimmer gui` or double-click `launch_clean_gui.bat`
2. **Select Ticker**: Choose a stock symbol (e.g., AAPL, MSFT, BRK.B)
3. **Download Data**: System opens StockRow page for manual data download
4. **Process Data**: Run `python process_financial_data.py TICKER`
5. **Analyze**: Use GUI "Calculate Owner Earnings" and "Create Visualizations" buttons
## 📊 Output Files
- **Charts**: `charts/[ticker]_*.png` - Visual analysis charts
- **Data**: `data/owner_earnings_*.csv` - Raw analysis data
- **Logs**: `logs/marketswimmer_*.log` - Application logs
## 💡 Owner Earnings Formula
```
Owner Earnings = Net Income + Depreciation/Amortization - CapEx - Working Capital Changes
```
## 🎯 Features
- ✅ Ticker-specific analysis
- ✅ Annual and quarterly data processing
- ✅ Professional visualizations
- ✅ Automated chart generation
- ✅ Clean directory organization
- ✅ Comprehensive logging
## 📋 Requirements
- Python 3.12+
- pandas, matplotlib, seaborn
- PyQt6 (for GUI)
- Internet connection (for data download)
Raw data
{
"_id": null,
"home_page": "https://github.com/jeremevans/MarketSwimmer",
"name": "marketswimmer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "finance, warren-buffett, owner-earnings, stocks, investment, financial-analysis",
"author": "Jeremy Evans",
"author_email": "Jeremy Evans <jeremyevans@hey.com>",
"download_url": "https://files.pythonhosted.org/packages/07/6d/65c2c9628fdc5c1df122d9f24d2b435c034f7591420df9c564db98eff90f/marketswimmer-2.5.3.tar.gz",
"platform": null,
"description": "# MarketSwimmer - Owner Earnings Analysis Tool \ud83c\udfca\u200d\u2642\ufe0f\ud83d\udcc8\r\n\r\nA comprehensive Python tool for analyzing Warren Buffett's \"Owner Earnings\" from financial statement data, now with robust quarterly support, enhanced fair value calculation, and professional visualizations.\r\n\r\n## \ud83d\ude80 What's New in v2.5.2 (2025-08-16)\r\n\r\n- **Accurate Quarterly Analysis:** Full quarter-by-quarter extraction and charting (no more Q1-only bug!)\r\n- **Improved Fair Value DCF:** Enhanced scenario modeling and balance sheet adjustments\r\n- **Cleaner Repo & Packaging:** Streamlined for PyPI, with automated cleanup and build scripts\r\n- **GUI & CLI:** Modern PyQt6 GUI and powerful command-line interface\r\n- **Professional Visualizations:** Multiple chart types, improved color schemes, and export options\r\n\r\n## Key Features\r\n\r\n- \ud83d\udcca **Owner Earnings & DCF Analysis:** 10-year average, scenario-based, and per-share valuation\r\n- \ud83d\uddc2\ufe0f **Automated Data Pipeline:** XLSX-to-CSV conversion, smart file detection, and logging\r\n- \ud83d\udda5\ufe0f **GUI & CLI:** Easy-to-use interface and full command-line support\r\n- \ud83d\udcc8 **Charts & Reports:** High-quality PNG charts and CSV exports for any ticker\r\n- \ud83d\udd0d **Open Source & Extensible:** MIT licensed, Python 3.8+, easy to extend\r\n\r\n## Quick Start\r\n\r\n```bash\r\npip install marketswimmer\r\nmarketswimmer gui\r\nmarketswimmer analyze TICKER\r\n```\r\n\r\n## \ud83d\udce6 **Installation**\r\n\r\n```bash\r\npip install marketswimmer\r\n```\r\n\r\n## \ufffd Quick Start\r\n\r\n### Command Line Usage\r\n\r\n```bash\r\n# Launch GUI\r\nmarketswimmer gui\r\n\r\n# Process downloaded data\r\npython process_financial_data.py TICKER\r\n\r\n# Create visualizations\r\nmarketswimmer visualize --ticker TICKER\r\n\r\n# Full analysis\r\nmarketswimmer analyze TICKER\r\n```\r\n\r\n### GUI Workflow\r\n\r\n1. **Launch GUI**: `marketswimmer gui` or double-click `launch_clean_gui.bat`\r\n2. **Select Ticker**: Choose a stock symbol (e.g., AAPL, MSFT, BRK.B)\r\n3. **Download Data**: System opens StockRow page for manual data download\r\n4. **Process Data**: Run `python process_financial_data.py TICKER`\r\n5. **Analyze**: Use GUI \"Calculate Owner Earnings\" and \"Create Visualizations\" buttons\r\n\r\n## \ud83d\udcca Output Files\r\n\r\n- **Charts**: `charts/[ticker]_*.png` - Visual analysis charts\r\n- **Data**: `data/owner_earnings_*.csv` - Raw analysis data\r\n- **Logs**: `logs/marketswimmer_*.log` - Application logs\r\n\r\n## \ud83d\udca1 Owner Earnings Formula\r\n\r\n```\r\nOwner Earnings = Net Income + Depreciation/Amortization - CapEx - Working Capital Changes\r\n```\r\n\r\n## \ud83c\udfaf Features\r\n\r\n- \u2705 Ticker-specific analysis\r\n- \u2705 Annual and quarterly data processing\r\n- \u2705 Professional visualizations\r\n- \u2705 Automated chart generation\r\n- \u2705 Clean directory organization\r\n- \u2705 Comprehensive logging\r\n\r\n## \ud83d\udccb Requirements\r\n\r\n- Python 3.12+\r\n- pandas, matplotlib, seaborn\r\n- PyQt6 (for GUI)\r\n- Internet connection (for data download)\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Modern Python tool for Buffett's Owner Earnings, DCF fair value, and robust quarterly analysis.",
"version": "2.5.3",
"project_urls": {
"Bug Reports": "https://github.com/jeremevans/MarketSwimmer/issues",
"Documentation": "https://github.com/jeremevans/MarketSwimmer/blob/main/README.md",
"Homepage": "https://github.com/jeremevans/MarketSwimmer",
"Source": "https://github.com/jeremevans/MarketSwimmer"
},
"split_keywords": [
"finance",
" warren-buffett",
" owner-earnings",
" stocks",
" investment",
" financial-analysis"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "94cd417412884fd890fa646e28b39990cdbd0514db6f0d7d1bba6055c72221d0",
"md5": "fdcb20c558b8d782ec3dc9ddcd80029b",
"sha256": "8fdb63f4f39f4f3d7a039d75d6f31eef83cac965473e4dca32abd920ceacbc9b"
},
"downloads": -1,
"filename": "marketswimmer-2.5.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fdcb20c558b8d782ec3dc9ddcd80029b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 74363,
"upload_time": "2025-08-16T13:12:07",
"upload_time_iso_8601": "2025-08-16T13:12:07.599137Z",
"url": "https://files.pythonhosted.org/packages/94/cd/417412884fd890fa646e28b39990cdbd0514db6f0d7d1bba6055c72221d0/marketswimmer-2.5.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "076d65c2c9628fdc5c1df122d9f24d2b435c034f7591420df9c564db98eff90f",
"md5": "c3fe3a21a247382e76c8c71fcf741519",
"sha256": "709782eeb47c95011c88f6782b29a3362f07840f0777b5be70849e93a767525b"
},
"downloads": -1,
"filename": "marketswimmer-2.5.3.tar.gz",
"has_sig": false,
"md5_digest": "c3fe3a21a247382e76c8c71fcf741519",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 84941,
"upload_time": "2025-08-16T13:12:08",
"upload_time_iso_8601": "2025-08-16T13:12:08.987920Z",
"url": "https://files.pythonhosted.org/packages/07/6d/65c2c9628fdc5c1df122d9f24d2b435c034f7591420df9c564db98eff90f/marketswimmer-2.5.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-16 13:12:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jeremevans",
"github_project": "MarketSwimmer",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "marketswimmer"
}
JSON
