Finoscop v1.0.3 Documentation
Complete user guide for Finoscop — Professional Financial Analysis Tool
Overview
Finoscop is a command-line financial analysis tool designed for investors and analysts. It provides comprehensive financial analysis capabilities including valuation models, risk assessment, and automated report generation.
Key Features
- 10+ valuation models including Graham formulas
- Automatic risk scoring system
- Multi-currency support (USD, RUB, CNY)
- Bilingual interface (English/Russian)
- Comprehensive report generation
- Sustainable Growth Rate (SGR) calculation
- Fair value range estimation
- Industry-specific risk assessment
- Altman Z-Score bankruptcy risk metric
System Requirements
- Windows 10/11 (64-bit)
- 4 GB RAM minimum, 8 GB recommended
- 50 MB free disk space
- x64 compatible processor
- UTF-8 console support
What's New in v1.0.3
Version 1.0.3 brings new features, performance improvements, and expanded technical details.
- Validated numerical calculations for valuation, profitability, liquidity, debt, and risk metrics
- Improved CLI debugging with the --debug option
- Improved risk scoring with weighted metrics and better handling of negative earnings
- EUR currency support
- Precision improvements and stable numerical algorithms (Kahan summation for aggregation)
- Multi-issue bond input with weighted debt yield and maturity calculations
- Added Altman Z-Score bankruptcy risk metric (interactive input and display)
Installation
- Download and run Finoscop-Setup-v1.0.3.exe
- Choose the installation folder in the installer; the default is C:\\Program Files\\Finoscop
- Choose whether to create a desktop shortcut; a Start menu shortcut is also created.
- No extra runtime is required for end users; the program is a native x64 Windows executable.
Developer/build dependencies (only required if you compile from source):
- GCC/MinGW-w64 (g++) or MSVC toolset to compile from source
- Optional: Git to fetch repository and build scripts
Note: The distributed binary does not require .NET or Visual C++ runtimes. On older Windows versions enable ANSI/VT processing for proper colored output.
Command Line Options
| Command | Description | Example | Show help message with all available options | finoscop.exe --help |
|---|---|---|
--version, -v |
Display program version information | finoscop.exe --version |
--license, -l |
Show license information | finoscop.exe --license |
--no-color, -nc |
Disable colored output (plain text) | finoscop.exe --no-color |
--lang=<ru|en> |
Force program language (ru or en) | finoscop.exe --lang=ru |
--debug |
Enable debug logging | finoscop.exe --debug |
Usage Guide
Starting the Program
Open Command Prompt and navigate to the Finoscop directory:
Start the program:
Or start with specific language:
License Agreement
Upon first launch, you'll be presented with a license agreement. You must accept it to continue using the program.
Interactive Analysis Process
Finoscop guides you through a step-by-step analysis process:
- Language Selection (if not specified)
- Currency Selection
- Basic Financial Data Input
- Industry Sector Selection
- Extended Financial Data Input
- Historical Data Input
- Data Review and Edit
- Analysis Results Display
- Report Generation (Optional)
Required Data for Analysis
To perform a complete financial analysis, Finoscop requires the following company data:
Basic Information
- Company ticker symbol (optional)
- Current market price per share
- Earnings per share (EPS) - last 12 months
- Expected earnings growth rate (%)
- Weighted yield from entered bond issues (%)
- Dividend per share
- Book Value per Share (BVPS) or equity components
- (Altman) Retained earnings, EBIT, Sales, Market value of equity (or price & shares)
Balance Sheet Data (in millions)
- Total assets
- Current assets
- Inventory
- Current liabilities
- Total debt or multiple bond issues
- Total equity
- Intangible assets
- Shares outstanding (millions)
Bond Issues
- Issue name or ISIN
- Principal amount in millions of the selected currency
- Coupon rate and yield to maturity
- Years to maturity and secured status
- Total debt, yield, and maturity are weighted by principal amount
Income Statement Data
- Net income for the year (millions)
Historical Data
- Annual profit for last 10 years (millions)
- Dividend payment history for 20 years (yes/no per year)
- All financial data should be entered in the selected currency
- Large numbers are entered in millions for convenience
- For loss years, enter negative numbers
- Both '.' and ',' are accepted as decimal separators
Currency Support
Finoscop supports three major currencies with adaptive thresholds:
| Currency | Symbol | Threshold Multiplier | Notes |
|---|---|---|---|
| US Dollars | $ | 1.0 | Base currency for calculations |
| Russian Rubles | ₽ | 100.0 | Adjusted for \~100:1 USD ratio |
| Chinese Yuan | ¥ | 7.0 | Adjusted for \~7:1 USD ratio |
| Euro | € | 0.85 | Experimental support; adjusted for ≈0.85:1 USD ratio |
Program Interface Examples
1. Program Startup
2. License and Main Menu
3. Industry Sector Selection
4. Data Input Process
5. Data Review Screen
6. Analysis Results
7. Report Generation
Risk Assessment System
Finoscop automatically evaluates multiple financial metrics and provides an overall risk assessment.
Risk Assessment Categories
Financial Health
- Total Assets (industry-specific)
- Current Ratio
- Quick Ratio
- Debt-to-Equity
Profitability
- Return on Equity - ROE (≥15%)
- Return on Assets - ROA
Valuation Metrics
- Price-to-Earnings - P/E
- Price-to-Book - P/B
Historical Stability
- 10-Year Profit Consistency
- 20-Year Dividend History
Altman Z-Score
Altman Z-Score is a classical bankruptcy prediction metric. Finoscop supports the original Altman formula (suitable for listed companies) and provides an interpretation band.
- Formula (original): Z = 1.2*(WorkingCapital/TotalAssets) + 1.4*(RetainedEarnings/TotalAssets) + 3.3*(EBIT/TotalAssets) + 0.6*(MarketValueEquity/TotalLiabilities) + 1.0*(Sales/TotalAssets)
- Interpretation: Z > 3.0 (Safe); 1.8 < Z <= 3.0 (Gray zone); Z <= 1.8 (High bankruptcy risk)
- Working capital = Current assets - Current liabilities. Market value of equity is computed as price per share * shares outstanding (ensure units match, use millions if other data is in millions).
- Interactive input: Altman data is requested during the standard input flow (y/n). There is no separate --altman or configuration-file option.
- Notes: For non-manufacturing or private firms, coefficients and interpretation may be adjusted; Finoscop treats Altman as an advisory metric combined with other risk checks.
Risk Levels
◯ Low Risk
0-2 issues
Excellent financial health
◐ Moderate Risk
3-4 issues
Good with some concerns
◑ High Risk
5-6 issues
Multiple warning signs
◉ Critical Risk
7+ issues
Significant financial issues
Report Generation
Finoscop can generate comprehensive text reports that include all analysis results. Reports are automatically saved with timestamps and ticker symbols.
Report Structure
- Header with company information
- Key financial ratios with risk assessment
- Intrinsic value estimates (Graham basic and modified)
- Margin of safety calculations
- Additional analysis (SGR, fair value range)
- Altman Z-Score (bankruptcy risk assessment)
- Historical stability analysis
- Overall risk assessment
- recommendation
- Footer with program information and license
File Naming Convention
Reports are saved with the following format:
If no ticker is provided, the filename starts with 'finoscop_report\_':
Technical Reference
This section provides technical details about calculation methods, data formats, and developer notes.
Calculation Methods
- Graham formulas: basic and modified implementations as described in program settings; modified uses 22.5 multiplier and adjusted EPS smoothing.
- SGR: Sustainable Growth Rate computed with ROE and retention ratio; capped to avoid unrealistic projections.
- Fair value range: ensemble of models (Graham, P/E-based, DCF-lite) averaged with outlier-resistant statistics.
- Risk scoring: weighted checklist of metrics; thresholds are industry- and currency-adjusted.
Troubleshooting
Common Issues
Program Won't Start
- Ensure the executable file is not corrupted
- Run as Administrator
- Check Windows Defender exclusions
- Verify UTF-8 console support
UTF-8 Display Issues
- Ensure console uses UTF-8 encoding
- Use Windows Terminal for better UTF-8 support
- Check if ANSI escape sequences are enabled
- Run with --no-color option if colors don't display
Input Validation Errors
- Enter positive numbers only for required fields
- Use decimal point (.) not comma (,)
- Values in millions for large numbers
- Use negative numbers for loss years
Report Generation Issues
- Ensure write permissions in program directory
- Check available disk space
- Close any open report files
- Avoid special characters in ticker names