Troubleshooting
Common issues and solutions
Common Issues
Application won't start
Solutions:
- Check that your system meets the platform requirements
- Try clearing the cache: Delete
~/.cache/cryptartist-studio(Linux/macOS) or%APPDATA%\cryptartist-studio(Windows) - Reinstall the application
- Check system logs for error messages
API keys not working
Solutions:
- Verify your API key is correct (copy/paste from provider website)
- Check that your API key has the correct permissions
- Ensure your account has sufficient credits/quota
- Try removing and re-adding the API key
- Check your internet connection
FFmpeg not found
Solutions:
- FFmpeg should auto-download on first run - wait a few minutes
- Manually install FFmpeg (see Configuration)
- Check that FFmpeg is in your system PATH
- Verify FFmpeg installation:
ffmpeg -version
Projects won't save
Solutions:
- Check that you have write permissions to the save directory
- Ensure you have sufficient disk space
- Try saving to a different location
- Check the application logs for error messages
- Try restarting the application
Performance is slow
Solutions:
- Close unnecessary programs to free up system resources
- Reduce timeline resolution in Media Mogul
- Disable real-time preview for complex effects
- Clear cache and temporary files
- Upgrade your system RAM or storage
- Check system monitor for resource usage
Crashes on startup
Solutions:
- Update to the latest version
- Clear application cache
- Disable hardware acceleration (if available)
- Check system logs for crash details
- Report the issue on GitHub Issues
Accessing Logs
Log File Locations
- Windows:
%APPDATA%\CryptArtist Studio\logs\ - macOS:
~/Library/Application Support/CryptArtist Studio/logs/ - Linux:
~/.config/cryptartist-studio/logs/
Log Files
- session.log - Current session log
- recent.log - Last 1,000 lines of activity
- history.log - Full history log
Enabling Debug Logging
Set the environment variable before launching:
# Windows (PowerShell)
$env:RUST_LOG="debug"
.\CryptArtist Studio.exe
# macOS/Linux
export RUST_LOG=debug
./cryptartist-studio
Getting Help
Resources
- Documentation: Read the full documentation
- GitHub Issues: Report bugs or request features
- Email Support: support@mattyjacks.com
- Security Issues: security@mattyjacks.com
Reporting Issues
When reporting an issue, please include:
- Your operating system and version
- CryptArtist Studio version
- Steps to reproduce the issue
- Error messages or logs
- Screenshots if applicable
Performance Optimization
System Requirements
- CPU: 4+ cores recommended
- RAM: 8GB minimum, 16GB+ recommended
- Storage: 10GB free space for installation and projects
- GPU: Dedicated GPU recommended for video editing
Optimization Tips
- Use SSD for project storage (faster than HDD)
- Close other applications to free up RAM
- Disable unnecessary visual effects
- Use lower resolution previews during editing
- Export at lower bitrates for faster rendering
- Keep your system updated
