|
58 | 58 | pip install -r requirements.txt |
59 | 59 | ``` |
60 | 60 |
|
61 | | -4. **Run the application:** |
| 61 | +4. **Prepare media paths (pick one):** |
| 62 | + - **Default (repo-relative):** place photos in `input/photos/`, background track as `input/audio.mp3`, and ensure `output/` exists for the rendered video. |
| 63 | + - **Custom paths:** set env vars before running: |
| 64 | + ```bash |
| 65 | + set PYMONTAGE_IMAGE_FOLDER="C:\path\to\photos" # Windows |
| 66 | + set PYMONTAGE_AUDIO_FILE="C:\path\to\music.mp3" |
| 67 | + set PYMONTAGE_OUTPUT_FILE="C:\path\to\slideshow.mp4" |
| 68 | + ``` |
| 69 | + (macOS/Linux: use `export VAR=value`) |
| 70 | + |
| 71 | +5. **Run the application:** |
62 | 72 | ```bash |
63 | 73 | python app.py |
64 | 74 | ``` |
65 | 75 |
|
66 | | -5. **Open your browser:** |
| 76 | +6. **Open your browser:** |
67 | 77 | Navigate to `http://127.0.0.1:5000` |
68 | 78 |
|
69 | 79 | ## 📖 Usage |
|
94 | 104 |
|
95 | 105 | ## ⚙️ Configuration Options |
96 | 106 |
|
| 107 | +### Paths & environment variables |
| 108 | +- Default (repo-relative): images in `input/photos/`, audio in `input/audio.mp3`, output to `output/slideshow.mp4`. |
| 109 | +- Override for CI/servers by setting `PYMONTAGE_IMAGE_FOLDER`, `PYMONTAGE_AUDIO_FILE`, `PYMONTAGE_OUTPUT_FILE`. |
| 110 | + |
97 | 111 | ### Basic Settings |
98 | 112 | - **Intro Text**: Opening title displayed at the beginning |
99 | 113 | - **Outro Text**: Closing title displayed at the end |
@@ -145,9 +159,11 @@ PyMontage/ |
145 | 159 | ├── templates/ |
146 | 160 | │ └── index.html # Web interface |
147 | 161 | ├── requirements.txt # Python dependencies |
148 | | -├── README.md # This file |
149 | | -├── temp_uploads/ # Temporary storage for uploaded files |
150 | | -└── temp_outputs/ # Temporary storage for generated videos |
| 162 | +├── README.md # This file |
| 163 | +├── input/ |
| 164 | +│ ├── photos/ # Default images location |
| 165 | +│ └── audio.mp3 # Default soundtrack |
| 166 | +└── output/ # Rendered videos (default target) |
151 | 167 | ``` |
152 | 168 |
|
153 | 169 | ### Supported Formats |
|
0 commit comments