Skip to content

Conversation

@cainky
Copy link
Owner

@cainky cainky commented Nov 12, 2025

Summary

Fixes #39 by implementing graceful error handling for geo-restricted tracks and adding proxy support.

Changes

  • Added exception handling for GeoRestrictedError in download_track()
  • Skip geo-restricted tracks instead of failing entire playlist download
  • Added optional proxy parameter to SoundCloudDownloader
  • Added --proxy CLI flag for automated/GitHub Actions workflows
  • Track and log skipped tracks with detailed summary reporting
  • Updated README with proxy usage examples and geo-restriction handling info

Test Plan

  • Test playlist download with geo-restricted tracks
  • Verify tracks are skipped gracefully without failing entire playlist
  • Test proxy flag functionality
  • Verify summary reporting shows both successful and skipped tracks

Related Issue

Closes #39

Resolves #39 by implementing graceful error handling for geo-restricted
tracks and adding proxy support for bypassing regional restrictions.

Changes:
- Add exception handling for GeoRestrictedError in download_track()
- Skip geo-restricted tracks instead of failing entire playlist download
- Add optional proxy parameter to SoundCloudDownloader
- Add --proxy CLI flag for automated/GitHub Actions workflows
- Track and log skipped tracks with detailed summary reporting
- Update README with proxy usage examples and geo-restriction handling info
- Add .claude/ to .gitignore

The downloader now continues processing available tracks when it encounters
geo-restricted content, providing a summary of successful downloads and
skipped tracks. Users can optionally configure a proxy to access restricted
content.
@cainky cainky merged commit 454583f into main Nov 12, 2025
3 checks passed
@cainky cainky deleted the fix-39-geo-restriction-handling branch November 12, 2025 23:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Playlist download fails on GitHub Actions due to SoundCloud geo restriction

2 participants