pyPhotoAlbum/GET_STARTED.md

🚀 Get Started with pyPhotoAlbum

Quick Installation (Recommended)

# Generate icons and install everything
./generate_icons.sh && ./install.sh

# Launch the app
pyphotoalbum

After installation, log out and back in to refresh GNOME. You can then launch from the terminal or by searching "photo" in Activities.

---

Alternative Installation Methods

📦 Fedora RPM Package

# Create source tarball
cd ..
tar czf pyphotoalbum-0.1.0.tar.gz pyPhotoAlbum/ --exclude=.git --exclude=venv --exclude=__pycache__
mv pyphotoalbum-0.1.0.tar.gz ~/rpmbuild/SOURCES/
cd pyPhotoAlbum

# Build and install
rpmbuild -ba pyphotoalbum.spec
sudo dnf install ~/rpmbuild/RPMS/noarch/pyphotoalbum-0.1.0-1.*.noarch.rpm

📦 Arch/CachyOS Package

# Create source tarball
cd ..
tar czf pyphotoalbum-0.1.0.tar.gz pyPhotoAlbum/ --exclude=.git --exclude=venv --exclude=__pycache__
mv pyphotoalbum-0.1.0.tar.gz pyPhotoAlbum/
cd pyPhotoAlbum

# Build and install
makepkg -si

💻 Development Installation

# Create virtual environment
python -m venv venv
source venv/bin/activate

# Install in editable mode with dev tools
pip install -e ".[dev]"

# Run the app
python pyPhotoAlbum/main.py

---

🎯 Features After Installation

✅ Command: pyphotoalbum available in terminal ✅ Icon: Beautiful camera icon in GNOME Activities ✅ Taskbar: Proper icon when app is running ✅ Menu: Right-click for "New Project" action ✅ Search: Find by typing "photo" in Activities ✅ Grouping: Multiple windows group under one icon

---

🆘 Troubleshooting

Command not found?

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Icon not showing?

./generate_icons.sh
./install.sh
rm -f ~/.cache/icon-cache.kcache

Then log out and back in.

Need detailed help?

See INSTALLATION.md for comprehensive installation instructions and troubleshooting.

---

Estimated time: 5-10 minutes Questions? Open an issue or check INSTALLATION.md