mirror of
https://github.com/lscambo13/ElegantFin.git
synced 2025-12-28 23:07:46 +00:00
Compare commits
12 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
c665c54f53 | ||
|
|
af6d340e8e | ||
|
|
fa0cf75972 | ||
|
|
ec7b63b431 | ||
|
|
0f8474eccd | ||
|
|
4083a7a0b9 | ||
|
|
8f27df07bc | ||
|
|
6a11b9cb60 | ||
|
|
c972bb0a48 | ||
|
|
bf4241a700 | ||
|
|
1fe65b63e6 | ||
|
|
872ac32747 |
68
README.md
68
README.md
@@ -1,15 +1,32 @@
|
||||
<!-- Banner Image -->
|
||||
<img src="https://github.com/lscambo13/ElegantFin/blob/main/Theme/assets/img/banner.png?raw=true" alt="ElegantFin Theme for Jellyfin - Banner">
|
||||
|
||||
# ⭐ ElegantFin Theme
|
||||
This is a Jellyfin theme inspired from Jellyseerr to improve the overall look and experience with various fixes to the UI/UX. It gives Jellyfin a fresh, modern look, and it aims to work on mobile, desktop, and TV, with just one import.
|
||||
<div align="center">
|
||||
<a href="https://www.jsdelivr.com/package/gh/lscambo13/ElegantFin">
|
||||
<img
|
||||
src="https://img.shields.io/jsdelivr/gh/hm/lscambo13/ElegantFin?style=flat&logo=jsdelivr&logoColor=%23f65e34&label=jsDelivr%20Hits&labelColor=white&color=%23f65e34"
|
||||
alt="jsDelivr Requests"
|
||||
/>
|
||||
</a>
|
||||
<br>
|
||||
<a href="https://github.com/lscambo13/ElegantFin/stargazers">
|
||||
<img
|
||||
src="https://img.shields.io/github/stars/lscambo13/ElegantFin?style=flat&logo=github&logoColor=%231f2328&label=GitHub%20Stars&labelColor=white&color=%231f2328"
|
||||
alt="GitHub Repo stars"
|
||||
/>
|
||||
</a>
|
||||
</div>
|
||||
|
||||
## ⭐ ElegantFin Theme
|
||||
|
||||
This is a Jellyfin theme inspired from Jellyseerr to improve the overall look and experience with various fixes to the UI/UX. It gives Jellyfin a fresh, modern look, and it aims to work on mobile, desktop, and TV, with just one import.
|
||||
|
||||
#### **Author:** [lscambo13](https://github.com/lscambo13)
|
||||
|
||||
<hr>
|
||||
|
||||
### ✨ Key Features
|
||||
|
||||
- modern layouts and color tones
|
||||
- new and improved animations on most elements
|
||||
- rounded corners and even spacing everywhere
|
||||
@@ -22,13 +39,14 @@ This is a Jellyfin theme inspired from Jellyseerr to improve the overall look an
|
||||
<hr>
|
||||
|
||||
### 🖼️ Theme Showcase
|
||||
|
||||
Captured on ElegantFin v25.08.02
|
||||
|
||||
<details>
|
||||
<summary> 💻 <i>Desktop and </i>📱 <i>Mobile Screenshots</i></summary>
|
||||
|
||||
| Desktop | Mobile |
|
||||
| ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| <div align="center"><img src="https://github.com/lscambo13/ElegantFin/blob/main/Previews/previews-v25.08.02/optimized/desktop/21.%20Login%20Page.webp?raw=true"><br><strong>Login Page</strong></div> | <div align="center"><img src="https://github.com/lscambo13/ElegantFin/blob/main/Previews/previews-v25.08.02/optimized/mobile/21.%20Login%20Page.webp?raw=true"></div> |
|
||||
| <div align="center"><img src="https://github.com/lscambo13/ElegantFin/blob/main/Previews/previews-v25.08.02/optimized/desktop/1.%20Homepage.webp?raw=true"><br><strong>Homepage</strong></div> | <div align="center"><img src="https://github.com/lscambo13/ElegantFin/blob/main/Previews/previews-v25.08.02/optimized/mobile/1.%20Homepage.webp?raw=true"></div> |
|
||||
| <div align="center"><img src="https://github.com/lscambo13/ElegantFin/blob/main/Previews/previews-v25.08.02/optimized/desktop/2.%20Movies%20Library.webp?raw=true"><br><strong>Movies Library</strong></div> | <div align="center"><img src="https://github.com/lscambo13/ElegantFin/blob/main/Previews/previews-v25.08.02/optimized/mobile/2.%20Movies%20Library.webp?raw=true"></div> |
|
||||
@@ -56,7 +74,7 @@ Captured on ElegantFin v25.08.02
|
||||
<summary> 📺 <i>TV Screenshots</i></summary>
|
||||
|
||||
| TV View |
|
||||
| ------------------------------------------------------------------------------------------------------------- |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| <div align="center"><img src="https://github.com/lscambo13/ElegantFin/blob/main/Previews/previews-v25.08.02/optimized/tv/21.%20Login%20Page.webp?raw=true"><br><strong>Login Page</strong></div> |
|
||||
| <div align="center"><img src="https://github.com/lscambo13/ElegantFin/blob/main/Previews/previews-v25.08.02/optimized/tv/1.%20Homepage.webp?raw=true"><br><strong>Homepage</strong></div> |
|
||||
| <div align="center"><img src="https://github.com/lscambo13/ElegantFin/blob/main/Previews/previews-v25.08.02/optimized/tv/2.%20Movies%20Library.webp?raw=true"><br><strong>Movies Library</strong></div> |
|
||||
@@ -77,12 +95,8 @@ Captured on ElegantFin v25.08.02
|
||||
|
||||
</details>
|
||||
|
||||
|
||||
|
||||
|
||||
https://github.com/user-attachments/assets/bb7f3174-b703-4c98-a23c-e6bb4abba390
|
||||
|
||||
|
||||
<hr>
|
||||
|
||||
### 👇 How to install/setup this theme?
|
||||
@@ -99,7 +113,7 @@ https://github.com/user-attachments/assets/bb7f3174-b703-4c98-a23c-e6bb4abba390
|
||||
3. Scroll down to find Custom CSS code box.
|
||||
4. Paste the custom css in Custom CSS code box.
|
||||
5. Click save
|
||||
</details>
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><i>Detailed steps for client-side implementation</i></summary>
|
||||
@@ -108,8 +122,7 @@ https://github.com/user-attachments/assets/bb7f3174-b703-4c98-a23c-e6bb4abba390
|
||||
2. Scroll down to find Custom CSS code box.
|
||||
3. Paste the custom css in Custom CSS code box.
|
||||
4. Click save.
|
||||
</details>
|
||||
|
||||
</details>
|
||||
|
||||
<hr>
|
||||
|
||||
@@ -150,7 +163,6 @@ https://github.com/user-attachments/assets/bb7f3174-b703-4c98-a23c-e6bb4abba390
|
||||
|
||||
<img width="400" height="auto" alt="image" src="https://github.com/user-attachments/assets/cb8479c2-c577-4d54-a567-697f54291a3b" />
|
||||
|
||||
|
||||
- To enable 'Mark Played' and 'Add to Favorites' buttons that show up at the bottom right corner of cards while hovering, copy and paste the following code at the end in Custom CSS box, click save and finally refresh your app/webpage.
|
||||
```
|
||||
:root{
|
||||
@@ -165,7 +177,6 @@ https://github.com/user-attachments/assets/bb7f3174-b703-4c98-a23c-e6bb4abba390
|
||||
|
||||
<img width="400" height="auto" alt="image" src="https://github.com/user-attachments/assets/ebde9db6-cd2f-47b5-bdb9-cee1e9852e2e" />
|
||||
|
||||
|
||||
- To bring the mini play button to the center of cards, copy and paste the following code at the end in Custom CSS box, click save and finally refresh your app/webpage.
|
||||
```
|
||||
:root{
|
||||
@@ -181,11 +192,13 @@ https://github.com/user-attachments/assets/bb7f3174-b703-4c98-a23c-e6bb4abba390
|
||||
https://github.com/user-attachments/assets/ac22440d-39d7-48d6-a8da-3b7777372ffd
|
||||
|
||||
- To disable the reflection on cards that shows when hovering over them on desktop, copy and paste the following code at the end in Custom CSS box, click save and finally refresh your app/webpage.
|
||||
|
||||
```
|
||||
:root{
|
||||
--cardHoverEffect: none;
|
||||
}
|
||||
```
|
||||
|
||||
- To undo this change, simply remove this code block or replace `none` with `""`.
|
||||
</details>
|
||||
|
||||
@@ -194,13 +207,14 @@ https://github.com/user-attachments/assets/ac22440d-39d7-48d6-a8da-3b7777372ffd
|
||||
|
||||
<img width="640" height="auto" alt="image" src="https://github.com/user-attachments/assets/5999a5de-5134-4b02-94aa-6306768a251c" />
|
||||
|
||||
|
||||
- To enable text labels under the media library cards, copy and paste the following code at the end in Custom CSS box, click save and finally refresh your app/webpage.
|
||||
|
||||
```
|
||||
:root{
|
||||
--libraryLabelVisibility: block;
|
||||
}
|
||||
```
|
||||
|
||||
- To undo this change, simply remove this code block or replace `block` with `none`.
|
||||
</details>
|
||||
|
||||
@@ -209,41 +223,55 @@ https://github.com/user-attachments/assets/ac22440d-39d7-48d6-a8da-3b7777372ffd
|
||||
|
||||
<img width="640" height="auto" alt="image" src="https://github.com/user-attachments/assets/3e88e270-40f9-48ba-8173-f65b94344f8d" />
|
||||
|
||||
|
||||
- ElegantFin does not support any plugins by default, so to to add external support for [this plugin](https://github.com/IAmParadox27/jellyfin-plugin-media-bar), copy and paste the following code at the end in Custom CSS box, click save and finally refresh your app/webpage.
|
||||
|
||||
```
|
||||
@import url("https://cdn.jsdelivr.net/gh/lscambo13/ElegantFin@main/Theme/assets/add-ons/media-bar-plugin-support-latest-min.css");
|
||||
```
|
||||
|
||||
- To undo this change, simply remove this code block.
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><i>8. Switch between different app bar styles</i></summary>
|
||||
|
||||
https://github.com/user-attachments/assets/b5868cd2-8df9-490d-a2b6-4386c6ddcd56
|
||||
https://github.com/user-attachments/assets/b5868cd2-8df9-490d-a2b6-4386c6ddcd56
|
||||
|
||||
- You can switch between these using `--appBarHeight`.
|
||||
- Use 5em to enable the fading app bar (seamless) (default);
|
||||
- Or, use 4.6em to get the solid app bar (cleaner with border)
|
||||
|
||||
```
|
||||
:root{
|
||||
/* example */
|
||||
--appBarHeight: 4.6em;
|
||||
}
|
||||
```
|
||||
|
||||
- To undo this change, simply remove this code block.
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><i>9. Change to alternative color themes</i></summary>
|
||||
|
||||
<img width="640" height="auto" alt="image" src="https://github.com/user-attachments/assets/0cab75aa-8fcd-4174-b0db-cc533b724bca" />
|
||||
|
||||
- Check out the [the theme Playground page](https://github.com/lscambo13/ElegantFin/discussions/221) for different color themes.
|
||||
- You can also experiment and share your own take there if you wish.
|
||||
</details>
|
||||
|
||||
<hr>
|
||||
|
||||
### 🆗 Tested on
|
||||
- Jellyfin Server v10.11.1
|
||||
|
||||
- Jellyfin Server v10.11.5
|
||||
- Microsoft Edge (Chromium)
|
||||
- Jellyfin Android App v2.6.3
|
||||
|
||||
<hr>
|
||||
|
||||
### 🛠️ Troubleshooting
|
||||
|
||||
<details>
|
||||
<summary>1️⃣ - <i>How do I check if I am using the latest version of ElegantFin?</i></summary>
|
||||
|
||||
@@ -282,13 +310,12 @@ https://github.com/user-attachments/assets/ac22440d-39d7-48d6-a8da-3b7777372ffd
|
||||
- It seems that modern Material Icons which this theme uses are [not compatible on some WebOS TVs](https://github.com/lscambo13/ElegantFin/issues/39). There is a [huge similar thread](https://www.reddit.com/r/youtubetv/comments/e27go3/chinese_symbols_instead_of_icons_on_lg_tv/) about this.
|
||||
- This bug can be fixed by using the older icons, so I have implemented the following workaround to bring back older, supported icons.
|
||||
- Simply add the following code at the end in Custom CSS box and save, then refresh your apps and webpages:
|
||||
|
||||
```
|
||||
:root{
|
||||
--iconPack: 'Material Icons';
|
||||
}
|
||||
```
|
||||
</details>
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>6️⃣ - <i>How do I report bugs/issues?</i></summary>
|
||||
@@ -296,7 +323,6 @@ https://github.com/user-attachments/assets/ac22440d-39d7-48d6-a8da-3b7777372ffd
|
||||
- First check [here](https://github.com/lscambo13/ElegantFin/issues?q=) whether a similar issue has been reported already. If it exists, upvote and comment there to let me know.
|
||||
- Alternatively, create a new issue [here](https://github.com/lscambo13/ElegantFin/issues/new/choose).
|
||||
|
||||
|
||||
</details>
|
||||
<details>
|
||||
<summary>7️⃣ - <i>When can I expect another update?</i></summary>
|
||||
@@ -310,8 +336,6 @@ https://github.com/user-attachments/assets/ac22440d-39d7-48d6-a8da-3b7777372ffd
|
||||
|
||||
Please read the [Contributor Guidelines](./CONTRIBUTING.md) before opening pull requests.
|
||||
|
||||
|
||||
### 🙏 Feedback Appreciated
|
||||
|
||||
Please use the right template when creating an [issue](https://github.com/lscambo13/ElegantFin/issues/new/choose) to [report bugs](https://github.com/lscambo13/ElegantFin/issues/new?template=bug_report.md) or [provide suggestions](https://github.com/lscambo13/ElegantFin/issues/new?template=feature_request.md).
|
||||
|
||||
|
||||
@@ -521,7 +521,7 @@ body {
|
||||
/* episode grid start */
|
||||
|
||||
@supports (display: revert) {
|
||||
.vertical-list:has(.listItem-largeImage) {
|
||||
.layout-desktop .vertical-list:has(.listItem-largeImage) {
|
||||
display: grid;
|
||||
grid-template-columns: repeat(auto-fill, minmax(min(var(--minEpisodeCardWidth), 100%), 1fr));
|
||||
gap: var(--itemColumnGap);
|
||||
@@ -1063,7 +1063,6 @@ body {
|
||||
#itemDetailPage .emby-scroller,
|
||||
#itemDetailPage .scrollX {
|
||||
margin: 0 calc(-1 * var(--sidePadding));
|
||||
padding: 0 var(--sidePadding);
|
||||
padding-left: calc(var(--sidePadding) - 0.375em);
|
||||
/* mask-image: linear-gradient(90deg, transparent, white var(--sidePadding), white calc(100vw - var(--sidePadding)), transparent); */
|
||||
}
|
||||
@@ -1075,10 +1074,14 @@ body {
|
||||
}
|
||||
|
||||
.emby-scroller,
|
||||
.hiddenScrollX.scrollX {
|
||||
.scrollX {
|
||||
padding-left: calc(var(--sidePadding) - 0.375em);
|
||||
}
|
||||
|
||||
.sectionTabs .scrollX {
|
||||
padding-left: 0;
|
||||
}
|
||||
|
||||
.itemsContainer:not(.editorsChoiceItemsContainer) {
|
||||
column-gap: var(--itemColumnGap);
|
||||
}
|
||||
@@ -1319,7 +1322,7 @@ body {
|
||||
|
||||
.layout-tv .detailImageContainer .card {
|
||||
width: 25vw !important;
|
||||
display: grid !important;
|
||||
display: block !important;
|
||||
position: fixed !important;
|
||||
top: 0;
|
||||
bottom: 0;
|
||||
@@ -3272,18 +3275,13 @@ div[data-role="controlgroup"] a.ui-btn-active {
|
||||
display: var(--itemOriginalTitleVisibility);
|
||||
}
|
||||
|
||||
.channelPrograms + .channelPrograms,
|
||||
.guide-channelHeaderCell + .guide-channelHeaderCell {
|
||||
margin-top: 0;
|
||||
}
|
||||
|
||||
.channelPrograms,
|
||||
.guide-channelHeaderCell,
|
||||
.programCell {
|
||||
border-color: transparent;
|
||||
/* this disables the 'color coded backgrounds' */
|
||||
background-color: transparent !important;
|
||||
border-radius: var(--smallRadius);
|
||||
height: 4.42em;
|
||||
}
|
||||
|
||||
.guideProgramName {
|
||||
@@ -3305,24 +3303,40 @@ div[data-role="controlgroup"] a.ui-btn-active {
|
||||
padding: 0;
|
||||
}
|
||||
|
||||
.guideChannelImage {
|
||||
background-color: rgba(255, 255, 255, 0.05);
|
||||
bottom: 0.35em;
|
||||
right: 0.35em;
|
||||
top: 0.35em;
|
||||
width: calc(100% - 0.7em);
|
||||
border-radius: var(--smallerRadius);
|
||||
.layout-mobile .guideChannelImage {
|
||||
background-position: center;
|
||||
width: calc(100% - var(--sidePadding));
|
||||
right: 0;
|
||||
}
|
||||
|
||||
.guide-channelHeaderCell {
|
||||
background-color: rgba(255, 255, 255, 0.125);
|
||||
margin: 0.35em 0.7em 0.7em 0.7em;
|
||||
width: auto;
|
||||
height: calc(4.42em - 0.7em);
|
||||
border-radius: var(--smallRadius);
|
||||
}
|
||||
|
||||
.guideChannelNumber {
|
||||
font-size: 1em;
|
||||
}
|
||||
|
||||
#guideTab {
|
||||
padding-top: 3em !important;
|
||||
}
|
||||
|
||||
.guide-channelHeaderCell:focus,
|
||||
.programCell:focus {
|
||||
.guide-channelHeaderCell:focus {
|
||||
background-color: var(--highlightOutlineColor) !important;
|
||||
}
|
||||
|
||||
.programCell:focus {
|
||||
background-color: transparent !important;
|
||||
}
|
||||
|
||||
.programCell:focus > .guideProgramName {
|
||||
background-color: var(--highlightOutlineColor);
|
||||
}
|
||||
|
||||
.emby-select-iconbutton {
|
||||
background-color: var(--selectorBackgroundColor);
|
||||
border: var(--defaultLighterBorder);
|
||||
@@ -3735,12 +3749,12 @@ ul.MuiList-root.MuiMenu-list.MuiList-dense > div:first-child {
|
||||
padding: 0;
|
||||
}
|
||||
|
||||
.headerTabs.sectionTabs {
|
||||
display: grid;
|
||||
.sectionTabs {
|
||||
display: inline-grid;
|
||||
height: var(--appBarHeight);
|
||||
}
|
||||
|
||||
.layout-mobile .headerTabs.sectionTabs {
|
||||
.layout-mobile .sectionTabs {
|
||||
align-content: center;
|
||||
}
|
||||
|
||||
@@ -3786,7 +3800,7 @@ ul.MuiList-root.MuiMenu-list.MuiList-dense > div:first-child {
|
||||
padding: 0 0.5em;
|
||||
}
|
||||
|
||||
/* this prevents the section tabs from hiding all the way up */
|
||||
/* this prevents the section tabs from hiding all the way up on phones (not-tablets)*/
|
||||
.headroom--unpinned {
|
||||
-webkit-transform: translateY(calc(-1 * var(--appBarHeight) - var(--borderWidth)));
|
||||
transform: translateY(calc(-1 * var(--appBarHeight) - var(--borderWidth)));
|
||||
@@ -3818,7 +3832,7 @@ ul.MuiList-root.MuiMenu-list.MuiList-dense > div:first-child {
|
||||
margin-right: 2em;
|
||||
}
|
||||
|
||||
.headerTabs.sectionTabs .emby-tab-button {
|
||||
.sectionTabs .emby-tab-button {
|
||||
display: inline-flex;
|
||||
margin: 0.25em 0.5em;
|
||||
padding: 0 1.25em;
|
||||
@@ -3829,20 +3843,12 @@ ul.MuiList-root.MuiMenu-list.MuiList-dense > div:first-child {
|
||||
background-color: var(--darkerGradientPointAlpha);
|
||||
}
|
||||
|
||||
.headerTabs.sectionTabs .emby-tab-button-active {
|
||||
.sectionTabs .emby-tab-button-active {
|
||||
margin: 0.25em 0.5em;
|
||||
color: black;
|
||||
background-color: var(--textColor);
|
||||
}
|
||||
|
||||
.layout-mobile .headerTabs.sectionTabs .emby-tab-button:first-child {
|
||||
margin-left: var(--sidePadding);
|
||||
}
|
||||
|
||||
.layout-mobile .headerTabs.sectionTabs .emby-tab-button:last-child {
|
||||
margin-right: var(--sidePadding);
|
||||
}
|
||||
|
||||
@media (min-width: 75em) {
|
||||
.sectionTabs {
|
||||
-webkit-align-items: center;
|
||||
@@ -3860,6 +3866,12 @@ ul.MuiList-root.MuiMenu-list.MuiList-dense > div:first-child {
|
||||
.libraryPage:not(.noSecondaryNavPage):not(.layout-tv .libraryPage) {
|
||||
padding-top: 6.8em !important;
|
||||
}
|
||||
|
||||
/* this fixes the header like on desktop on larger tablet screens */
|
||||
.headroom--unpinned {
|
||||
-webkit-transform: translateY(0);
|
||||
transform: translateY(0);
|
||||
}
|
||||
}
|
||||
|
||||
@media (max-width: 100em) {
|
||||
@@ -3869,6 +3881,17 @@ ul.MuiList-root.MuiMenu-list.MuiList-dense > div:first-child {
|
||||
}
|
||||
}
|
||||
|
||||
@media (max-width: 75em) {
|
||||
/* these margins are applied only on phones, not tablets*/
|
||||
.layout-mobile .sectionTabs .emby-tab-button:first-child {
|
||||
margin-left: var(--sidePadding);
|
||||
}
|
||||
|
||||
.layout-mobile .sectionTabs .emby-tab-button:last-child {
|
||||
margin-right: var(--sidePadding);
|
||||
}
|
||||
}
|
||||
|
||||
/* this increased top page padding when section tabs are maximised */
|
||||
.libraryPage:not(.noSecondaryNavPage) {
|
||||
padding-top: 9.5em !important;
|
||||
@@ -3914,22 +3937,13 @@ ul.MuiList-root.MuiMenu-list.MuiList-dense > div:first-child {
|
||||
z-index: -1;
|
||||
}
|
||||
|
||||
.layout-mobile .headerTop {
|
||||
height: calc(var(--appBarHeight) - 1em);
|
||||
}
|
||||
|
||||
.headerTabs.sectionTabs {
|
||||
.sectionTabs {
|
||||
padding-bottom: 1.5em;
|
||||
}
|
||||
|
||||
.layout-mobile .headerTabs.sectionTabs {
|
||||
.layout-mobile .sectionTabs {
|
||||
align-content: center;
|
||||
}
|
||||
|
||||
.headroom--unpinned {
|
||||
-webkit-transform: translateY(calc(-0.75 * var(--appBarHeight) - var(--borderWidth)));
|
||||
transform: translateY(calc(-0.75 * var(--appBarHeight) - var(--borderWidth)));
|
||||
}
|
||||
}
|
||||
|
||||
.nowPlayingPage {
|
||||
|
||||
@@ -9,5 +9,9 @@
|
||||
"editor.formatOnSave": true,
|
||||
"prettier.useTabs": false,
|
||||
"prettier.printWidth": 120,
|
||||
"cSpell.words": [
|
||||
"Jellyfin",
|
||||
"Jellyseerr"
|
||||
],
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user