Metadata-Version: 2.1
Name: py-tomfoolery
Version: 0.0.8
Summary: SoundCloud / YouTube / Bandcamp downloader /w a GUI
Author: Tom Krut
Project-URL: Repository, https://github.com/tomkrut/tomfoolery.git
Keywords: soundcloud,youtube,bandcamp,scraper,downloader
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyQt6 >=6.5.2
Requires-Dist: appdirs >=1.4.4
Requires-Dist: clint >=0.5.1
Requires-Dist: debugpy >=1.6.7
Requires-Dist: demjson3 >=3.0.6
Requires-Dist: ffmpeg-python >=0.2.0
Requires-Dist: moviepy >=1.0.3
Requires-Dist: mutagen >=1.46.0
Requires-Dist: pathvalidate >=3.0.0
Requires-Dist: pytube >=15.0.0
Requires-Dist: Requests >=2.31.0
Requires-Dist: soundcloud-v2 >=1.3.1
Requires-Dist: tqdm >=4.65.0

# Tomfoolery

This is a *SoundCloud* / *Bandcamp* / *YouTube* downloader.

<img alt="demo.gif" src="https://raw.githubusercontent.com/tomkrut/tomfoolery/master/media/demo_small.gif">

## Installation

1. Get [ffmpeg](https://ffmpeg.org) binary and add it to your path manually, or  

   ```python
   conda install -c anaconda ffmpeg
   ```

2. Install tomfoolery.

   ```python
   pip install py-tomfoolery
   ```

### Usage

Enter following in the terminal.

```python
tomfoolery
```

### Configuration

- Menu *File*.
  - *Directories*.
    - *SoundCloud* downloads directory.
    - *Bandcamp* downloads directory.
    - *YouTube* downloads directory.
  - *Config*.
    - Organize saved songs in folders by the *artist*.
    - Organize saved songs in folders by the *album*.

### Metadata editing

*Artist* / *Title* / *Album* can be edited by double-clicking a corresponding entry.  
The change will reflect both in the filename and in the file metadata.

## Acknowledgements

Tomfoolery is using bits and pieces from other repos, off the top of my head:

- [pytube/pytube](https://github.com/pytube/pytube),
- [Miserlou/SoundScrape](https://github.com/Miserlou/SoundScrape),
- [flyingrub/scdl](https://github.com/flyingrub/scdl),
- [better-ffmpeg-progress](https://github.com/CrypticSignal/better-ffmpeg-progress).
