Metadata-Version: 2.4
Name: PIP_lastfm-python_lule345
Version: 1.0.12
Summary: A small Last.Fm search client written in python able to executed in terminal; Functions as a way for me to practice Python as beginner
Author-email: Malingen <admin@malingen.xyz>
License-Expression: GPL-3.0-or-later
Project-URL: Github, https://github.com/lule345/lastfm-python/tree/main
Project-URL: Website, https://malingen.xyz/
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.13.0
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: climage
Requires-Dist: kdtree
Dynamic: license-file

# lastfm-python
A small Last.Fm search client written in python able to executed in terminal; Functions as a way for me to practice Python as beginner

Due to my previous git repo, https://github.com/lule345/lastfm-python/, somehow getting bugged by VS code not handling git correctly, I had to remake the repo and so this is why this is here. You can still find the original repo with the link before.

Demonstration video can be found at: https://youtu.be/qNmmetEVYJQ

Usage:
1. ``pipx install PIP-lastfm-python-lule345``
2. ``lastfmPython``
3. Configure the local ``config.json`` file to include API key (see: https://www.last.fm/api/account/create; you will require a last.fm account)
4. The JSON file will look like: ``{"api_key": "YOUR_API_KEY_HERE"}``; Upon getting your API key from last.fm, insert your key in the field there, save, and continue to step 5.
5. ``lastfmPython --h``

Options/Features:

```
options:
  -h, --help                                show this help message and exit
  --user, -u [user]                         queries for a given user's info
  --userRecentTracks [user]                 queries for a user's recent tracks
  --userTopTracks [user]                    queries for a user's top tracks, time defaults to overall
  --track, -t [name] [artist]               queries for a given track name and artist; use underscore for spaces
  --toptracks                               queries for the top tracks on lastfm
  --topartists                              queries for the top artists on lastfm
  --album, -a [name] [artist]               queries for a given album name and artist; use underscore for spaces
  --artist [artist]                         queries for a given artist name; use underscore for spaces
  -v, --verbose                             prints API key, HTTP info
```


- Supply your own Last.Fm API Key (see: https://www.last.fm/api/account/create)
- Licensed under GNU General Public License v3
- Available at PIP: https://pypi.org/project/PIP-lastfm-python-lule345/

![screenshot demo of lastfm.py](/screenshot1.png)
