6 Commits
0.1.0 ... 0.2.3

Author SHA1 Message Date
b6e90be86f v0.2.3 2025-07-21 22:06:09 +02:00
0ab0a00a77 fix rate limit 2025-07-21 21:48:01 +02:00
9bb48dcc47 increase limit 2025-07-21 21:29:27 +02:00
8a3b87d242 bump version 2025-07-21 21:15:26 +02:00
ee078d9da9 magic dithering 2025-07-21 21:14:40 +02:00
b4420e334d small improvements 2025-07-21 20:44:30 +02:00
3 changed files with 271 additions and 100 deletions

View File

@ -12,6 +12,14 @@ from PIL import Image
from typing import List, Dict, Any
import pandas as pd
import re
from enum import Enum
MAX_ALBUM_IMG_SIZE = 512
class CardStyle(str, Enum):
FULL_ALBUM_COVER = "full album cover"
MINIMAL = "minimal"
PRINT_FRIENDLY_BW = "dithered bw album cover (slow, print friendly)"
class Hipsterfy(object):
@ -42,16 +50,15 @@ class HipsterfyPlaylistItem(object):
return img_html
def generate_hipsterfy_front_card(self, include_preview:bool = False, print_mode:bool = False):
def generate_hipsterfy_front_card(self, include_preview:bool = False, card_style:CardStyle = CardStyle.FULL_ALBUM_COVER):
# generates the square front card only with the centered qr code
preview_html = self.embed_html if include_preview else ""
if not self._qr_html:
return ""
if print_mode:
# Minimalistisches Layout für Druck: kein Hintergrund, kein Schatten, kein Rahmen
card_style = """
width: 300px; height: 300px;
border: 1.5px;
border: 1px dashed #bbb; /* sehr dezente, gestrichelte Linie */
border-radius: 18px;
display: flex;
align-items: center;
@ -61,19 +68,7 @@ class HipsterfyPlaylistItem(object):
box-shadow: none;
transition: none;
"""
else:
card_style = """
width: 300px; height: 300px;
border: 1.5px solid #222;
border-radius: 18px;
display: flex;
align-items: center;
justify-content: center;
background: linear-gradient(135deg, #f9f9f9 60%, #e0e0e0 100%);
margin: 18px;
box-shadow: 0 6px 24px rgba(0,0,0,0.13), 0 1.5px 4px rgba(0,0,0,0.07);
transition: box-shadow 0.2s;
"""
return f"""
<div style="{card_style}">
<div style="text-align: center;">
@ -89,28 +84,106 @@ class HipsterfyPlaylistItem(object):
</div>
"""
def generate_hipsterfy_back_card(self, primary_property, secondary_property, additional_properties:List[str]=None, album_cover_gb:bool = True, print_mode:bool = False):
# generates the back card with primary and secondary property and additional properties
def generate_hipsterfy_back_card(
self,
primary_property,
secondary_property,
additional_properties: List[str] = None,
card_style: CardStyle = CardStyle.FULL_ALBUM_COVER
):
additional_html = ""
if additional_properties:
for prop in additional_properties:
value = getattr(self, f"{prop}", "N/A")
additional_html += f"<div style='margin: 4px 0; color:#fff;'><strong style='color:#fff;'>{prop.replace('_', ' ').title()}:</strong> <span style='color:#fff;'>{value}</span></div>"
additional_html += f"<div style='margin: 4px 0; color:#e0e0e0;'><strong style='color:#fff;'>{prop.replace('_', ' ').title()}:</strong> <span style='color:#fff;'>{value}</span></div>"
# Albumcover als Hintergrund
album_bg = ""
if album_cover_gb and self.album_images and len(self.album_images) > 0:
album_url = self.album_images[0]['url']
album_bg = f"""
background:
linear-gradient(135deg, rgba(30,30,30,0.65) 60%, rgba(0,0,0,0.85) 100%),
url('{album_url}') center center/cover no-repeat;
# Style für die innere Box (Textfeld)
inner_box_style_full = """
width: 250px;
height: 250px;
margin: auto;
background: rgba(0,0,0,0.35);
border-radius: 18px;
padding: 24px 18px 18px 18px;
display: flex;
flex-direction: column;
justify-content: center;
align-items: center;
box-sizing: border-box;
position: relative;
z-index: 1;
backdrop-filter: blur(2px);
-webkit-backdrop-filter: blur(2px);
"""
inner_box_style_minimal = """
width: 250px;
height: 250px;
margin: auto;
background: #fff;
border-radius: 18px;
box-shadow: 0 2px 8px rgba(0,0,0,0.15);
padding: 24px 18px 18px 18px;
display: flex;
flex-direction: column;
justify-content: center;
align-items: center;
box-sizing: border-box;
position: relative;
z-index: 1;
"""
else:
album_bg = "background: #f9f9f9;"
if CardStyle(card_style) == CardStyle.PRINT_FRIENDLY_BW and self.album_images and len(self.album_images) > 0:
album_b64 = self.get_bw_album_img_base64()
outer_style = f"""
width: 300px; height: 300px;
border: 2px solid #222;
border-radius: 18px;
display: flex;
flex-direction: column;
justify-content: center;
align-items: center;
background: url('data:image/png;base64,{album_b64}') center center/cover no-repeat;
background-blend-mode: multiply;
background-color: #fff;
margin: 18px;
box-shadow: none;
color: #222;
overflow: hidden;
position: relative;
"""
inner_box_style = """
width: 250px;
height: 250px;
margin: auto;
background: rgba(255,255,255,0.9);
border-radius: 18px;
box-shadow: 0 2px 8px rgba(0,0,0,0.15);
padding: 18px 12px 12px 12px;
display: flex;
flex-direction: column;
justify-content: center;
align-items: center;
box-sizing: border-box;
position: relative;
z-index: 1;
"""
primary_color = "#222"
secondary_color = "#444"
additional_html = additional_html.replace("color:#fff", f"color:{secondary_color}")
additional_html = additional_html.replace("color:#e0e0e0", f"color:{secondary_color}")
return f"""
<div style="
<div style="{outer_style}">
<div style="{inner_box_style}">
<p style="margin: 0 0 8px 0; font-size: 1.1em; color: {secondary_color};">{getattr(self, secondary_property)}</p>
<h3 style="margin: 0 0 8px 0; font-size: 1.25em; color: {primary_color};">{getattr(self, primary_property)}</h3>
{additional_html}
</div>
</div>
"""
# FULL_ALBUM_COVER: Albumcover als Hintergrund, weiße Schrift, abgedunkelte Box
if CardStyle(card_style) == CardStyle.FULL_ALBUM_COVER and self.album_images and len(self.album_images) > 0:
album_url = self.album_images[0]['url']
outer_style = f"""
width: 300px; height: 300px;
border: 1.5px solid #222;
border-radius: 18px;
@ -118,17 +191,48 @@ class HipsterfyPlaylistItem(object):
flex-direction: column;
justify-content: center;
align-items: center;
{album_bg}
background:
linear-gradient(135deg, rgba(30,30,30,0.65) 60%, rgba(0,0,0,0.85) 100%),
url('{album_url}') center center/cover no-repeat;
margin: 18px;
box-shadow: 0 6px 24px rgba(0,0,0,0.13), 0 1.5px 4px rgba(0,0,0,0.07);
color: #fff;
overflow: hidden;
position: relative;
transition: box-shadow 0.2s;
">
<div style="text-align: center; padding: 24px 18px 18px 18px; background: rgba(0,0,0,0.35); border-radius: 12px;">
<p style="margin: 0 0 12px 0; font-size: 1.1em; color: #e0e0e0; text-shadow: 0 1px 4px #000;">{getattr(self, secondary_property)}</p>
<h3 style="margin: 0 0 8px 0; font-size: 1.35em; color: #fff; text-shadow: 0 2px 8px #000;">{getattr(self, primary_property)}</h3>
"""
text_color = "#fff"
primary_color = "#fff"
secondary_color = "#e0e0e0"
inner_box_style = inner_box_style_full
# MINIMAL: Weißer Hintergrund, schwarze Schrift, nur Kontur
else:
outer_style = """
width: 300px; height: 300px;
border: 2px solid #222;
border-radius: 18px;
display: flex;
flex-direction: column;
justify-content: center;
align-items: center;
background: #fff;
margin: 18px;
box-shadow: none;
color: #222;
overflow: hidden;
position: relative;
transition: box-shadow 0.2s;
"""
inner_box_style = inner_box_style_minimal
additional_html = additional_html.replace("color:#fff", "color:#222")
primary_color = "#222"
secondary_color = "#444"
return f"""
<div style="{outer_style}">
<div style="{inner_box_style}">
<p style="margin: 0 0 12px 0; font-size: 1.1em; color: {secondary_color}; text-shadow: none;">{getattr(self, secondary_property)}</p>
<h3 style="margin: 0 0 8px 0; font-size: 1.35em; color: {primary_color}; text-shadow: none;">{getattr(self, primary_property)}</h3>
{additional_html}
</div>
</div>
@ -259,6 +363,32 @@ class HipsterfyPlaylistItem(object):
def qr_html(self):
return self._qr_html
def get_bw_album_img_html(self):
b64 = self.get_bw_album_img_base64()
if b64:
return f'<img src="data:image/png;base64,{b64}" style="width:{MAX_ALBUM_IMG_SIZE}px;height:{MAX_ALBUM_IMG_SIZE}px;border-radius:12px;box-shadow:0 2px 8px #aaa;margin-bottom:8px;" alt="Album Art BW"/>'
return ""
def get_bw_album_img_base64(self):
if self.album_images and len(self.album_images) > 0:
url = self.album_images[0]['url']
try:
import requests
from PIL import Image, ImageOps, ImageEnhance
response = requests.get(url)
img = Image.open(BytesIO(response.content)).convert("L")
img.thumbnail((MAX_ALBUM_IMG_SIZE, MAX_ALBUM_IMG_SIZE))
img = ImageOps.autocontrast(img)
img = ImageEnhance.Contrast(img).enhance(2.0) # Kontrast erhöhen
img = img.convert("1", dither=Image.FLOYDSTEINBERG, colors=12) # Stärkeres Dithering
buffer = BytesIO()
img.save(buffer, format="PNG")
img_str = base64.b64encode(buffer.getvalue()).decode()
return img_str
except Exception:
return ""
return ""
class HipsterfyPlaylist(object):
def __init__(self, playlist_uri, hipsterfy:Hipsterfy):
@ -270,8 +400,18 @@ class HipsterfyPlaylist(object):
"""Load the playlist data from Spotify and extract track information.
"""
playlist_id = self._playlist_uri.split("/")[-1].split("?")[0]
results = self._hipsterfy.sp.playlist_items(playlist_id, additional_types=['track'])
self._tracks_data = [HipsterfyPlaylistItem(item['track']) for item in results['items'] if item['track']]
results = []
last_page_reached = False
offset = 0
while not last_page_reached:
page_results = self._hipsterfy.sp.playlist_items(playlist_id, additional_types=['track'], limit=100, offset=offset)
tracks = [item['track'] for item in page_results['items'] if item['track']]
if not tracks:
last_page_reached = True
else:
results.extend(page_results['items'])
offset += len(page_results['items'])
self._tracks_data = [HipsterfyPlaylistItem(item['track']) for item in results]
def get_tracks_data(self) -> List[HipsterfyPlaylistItem]:
"""Returns the list of HipsterfyPlaylistItem objects representing the tracks in the playlist.
"""

View File

@ -1,10 +1,13 @@
import panel as pn
import base64
from io import BytesIO
from hipsterfy.hipsterfy import Hipsterfy, HipsterfyPlaylist, HipsterfyPlaylistItem
from hipsterfy.hipsterfy import Hipsterfy, HipsterfyPlaylist, HipsterfyPlaylistItem, CardStyle
pn.extension("filedownload", "notifications", "location")
def create_panel_page(hipsterfy: Hipsterfy, playlist_uri: str=None) -> pn.Template:
# create widgets
@ -12,32 +15,43 @@ def create_panel_page(hipsterfy: Hipsterfy, playlist_uri: str=None) -> pn.Templa
primary_item = pn.widgets.Select(name='Primary Item', options=HipsterfyPlaylistItem.get_available_properties(), value="release_year")
secondary_item = pn.widgets.Select(name='Secondary Item', options=HipsterfyPlaylistItem.get_available_properties(), value="title")
additional_items = pn.widgets.MultiChoice(name='Additional Items', options=HipsterfyPlaylistItem.get_available_properties(), value=["artists", "album", "popularity"])
enable_album_art = pn.widgets.Checkbox(name='Enable Album Art', value=True)
print_mode_in_preview = pn.widgets.Checkbox(name='Print Mode in preview', value=True)
cards_per_row_widget = pn.widgets.IntSlider(name="Cards per Row in print", start=1, end=6, value=4, step=1)
card_style = pn.widgets.Select(name='Card Style', options=[style.value for style in CardStyle], value=CardStyle.FULL_ALBUM_COVER.value)
cards_per_row_widget = pn.widgets.IntSlider(name="Cards per Row in print", start=1, end=8, value=4, step=1)
pn.state.location.sync(playlist_uri, {"value": "playlist_uri"})
pn.state.location.sync(primary_item, {"value": "primary_item"})
pn.state.location.sync(secondary_item, {"value": "secondary_item"})
pn.state.location.sync(additional_items, {"value": "additional_items"})
pn.state.location.sync(enable_album_art, {"value": "enable_album_art"})
pn.state.location.sync(card_style, {"value": "card_style"})
pn.state.location.sync(cards_per_row_widget, {"value": "cards_per_row"})
create_preview_button = pn.widgets.Button(name='Create Preview', button_type='primary')
create_preview_button = pn.widgets.Button(name='Parse Playlist and Generate Cards', button_type='primary', sizing_mode='stretch_width')
front_cards_column = pn.Column(sizing_mode='stretch_width')
back_cards_column = pn.Column(sizing_mode='stretch_width')
# FileDownload-Buttons (werden erst nach Preview-Generierung angezeigt)
download_front_html_button = pn.widgets.FileDownload(
label="Download Front Cards (HTML)", button_type="success", visible=False, filename="hipsterfy_front_cards.html"
label="Download Front Cards (HTML)", button_type="success", visible=False, filename="hipsterfy_front_cards.html", sizing_mode='stretch_width'
)
download_back_html_button = pn.widgets.FileDownload(
label="Download Back Cards (HTML)", button_type="success", visible=False, filename="hipsterfy_back_cards.html"
label="Download Back Cards (HTML)", button_type="success", visible=False, filename="hipsterfy_back_cards.html", sizing_mode='stretch_width'
)
playlist_instructions = pn.pane.HTML(
"""
<div>
<h3>Playlist Instructions</h3>
<p>Select any Spotify playlist and click the "Parse Playlist and Generate Cards" button to generate the cards.</p>
<p><b>Note:</b> The playlist must be public accessible. Also dynamically individualized playlists (unfortunately a lot of spotify official playlists) Will not work.</p>
</div>
""",
sizing_mode='stretch_width'
)
print_instructions = pn.pane.HTML(
"""
<div style="background-color: #f0f0f0; padding: 12px; border-radius: 8px; box-shadow: 0 2px 4px rgba(0,0,0,0.1);">
<div>
<h3>Print Instructions</h3>
<p>To print the cards:</p>
<ol>
@ -100,11 +114,16 @@ def create_panel_page(hipsterfy: Hipsterfy, playlist_uri: str=None) -> pn.Templa
pn.state.notifications.success("Download buttons updated successfully!. Download and print them from the sidebar")
def create_preview(event):
try:
pn.state.notifications.info("Generating preview for playlist...")
# clear previous cards
front_cards_column.clear()
back_cards_column.clear()
front_cards_column.loading = True
back_cards_column.loading = True
front_cards_column.append(pn.pane.HTML("<h2>Front Cards</h2>", sizing_mode='stretch_width'))
back_cards_column.append(pn.pane.HTML("<h2>Back Cards</h2>", sizing_mode='stretch_width'))
@ -117,31 +136,43 @@ def create_panel_page(hipsterfy: Hipsterfy, playlist_uri: str=None) -> pn.Templa
# create HipsterfyPlaylist instance
hipsterfy_playlist = HipsterfyPlaylist(uri, hipsterfy)
new_back_cards = []
new_front_cards = []
# generate front and back cards for each item in the playlist
for item in hipsterfy_playlist.get_tracks_data():
front_card = item.generate_hipsterfy_front_card(include_preview=False, print_mode=print_mode_in_preview.value)
front_card = item.generate_hipsterfy_front_card(include_preview=False, card_style=CardStyle(card_style.value))
back_card = item.generate_hipsterfy_back_card(
primary_property=primary_item.value,
secondary_property=secondary_item.value,
additional_properties=additional_items.value,
album_cover_gb=enable_album_art.value,
print_mode=print_mode_in_preview.value
card_style=CardStyle(card_style.value)
)
front_cards_column.append(pn.pane.HTML(front_card, sizing_mode='stretch_width'))
back_cards_column.append(pn.pane.HTML(back_card, sizing_mode='stretch_width'))
new_front_cards.append(pn.pane.HTML(front_card, sizing_mode='stretch_width'))
new_back_cards.append(pn.pane.HTML(back_card, sizing_mode='stretch_width'))
for card in new_front_cards:
front_cards_column.append(card)
for card in new_back_cards:
back_cards_column.append(card)
pn.state.notifications.success("Preview generated successfully!")
pn.state.notifications.info("Prepare to download the cards as HTML files...")
update_download_buttons()
except Exception as e:
pn.state.notifications.error(f"Error generating preview: {str(e)}")
finally:
front_cards_column.loading = False
back_cards_column.loading = False
create_preview_button.on_click(create_preview)
template = pn.template.FastListTemplate(
title='Hipsterfy Playlist Manager',
title='Hipsterfy',
sidebar=[
playlist_uri, primary_item, secondary_item, additional_items, enable_album_art,
playlist_instructions, playlist_uri, primary_item, secondary_item, additional_items, card_style,
cards_per_row_widget,
create_preview_button, print_instructions, download_front_html_button, download_back_html_button
create_preview_button, download_front_html_button, download_back_html_button, print_instructions
],
main=[pn.Row(front_cards_column, back_cards_column, sizing_mode='stretch_width')],
accent_base_color='indigo',

View File

@ -1,6 +1,6 @@
[project]
name = "hipsterfy"
version = "0.1.0"
version = "0.2.3"
description = ""
authors = [
{name="Jonas Weinz"}
@ -16,7 +16,7 @@ dependencies = [
]
[tool.poetry]
name = "hipsterfy"
version = "0.1.0"
version = "0.2.3"
description = ""
authors = [
"Jonas Weinz"