README-is.md

YouTube Tónlist

Electron umbúðir utan um YouTube Tónlist sem inniheldur:

• Innfæddur útlit og tilfinning, miðar að því að halda upprunalegu viðmótinu
• Rammi fyrir sérsniðnar tengiforrit: breyttu YouTube Tónlist að þínum þörfum (stíl, efni, eiginleikar), virkjaðu/slökktu á viðbætur í einn smellur

Sýnishornsmynd

Spilaraskjár (albúmslitaþema & umhverfisljós)

Efni

• Eiginleikar
• Tiltæk tengiforrit
• Þýðing
• Sækja
  • Arch Linux
  • MacOS
  • Windows
    • Hvernig á að setja upp án nettengingar? (í Windows)
• Þemu
• Þróun
• Búðu til þín eigin viðbætur
  • Er að búa til viðbót
  • Algeng notkunartilvik
• Byggja
• Framleiðsluforskoðun
• Prófanir
• Leyfi
• Algengustu spurningar

Eiginleikar:

• Sjálfvirk staðfesting þegar gert er hlé (Alltaf virkt): slökkva á "Halda áfram að horfa?" popup sem gerir hlé á tónlist eftir ákveðinn tíma

• Og meira...

Tiltæk tengiforrit:

• Auglýsingablokkari: Lokaðu fyrir allar auglýsingar og rakningar úr kassanum

• Albúmsaðgerðir: Bætir Ódíslika, Mislíkt, Líkt, og Ólíkt til að nota þetta á öll lög á spilunarlista eða albúm

• Albúmslitaþema: Beitir kraftmikið þema og sjónrænum áhrifum sem byggjast á litavali albúmsins

• Umhverfishamur: Beitir lýsingaráhrifum með því að varpa mildum litum úr myndbandinu í bakgrunn skjásins

• Hljóðþjöppur: Notaðu þjöppun á hljóð (lækkar hljóðstyrk háværustu hluta merkis og hækkar hljóðstyrk í mýkstu hlutunum)

• Þoka Leiðsagnarstika: Gerir leiðsögustikuna gagnsæja og óskýrt

• Farið Framhjá Aldurstakmörkunum: Framhjá aldursstaðfestingu YouTube

• Yfirskriftarval: Virkja skjátexta

• Fyrirferðarlítillhliðarstika: Stilltu hliðarstikuna alltaf í þétta stillingu

• Krossfæra: Krossfæra á milli lög

• Slökkva á Sjálfvirkri Spilun: Gerir lag að byrja í "hlé" ham

• Discord Rík Nærveru: Sýndu vinum þínum hvað þú hlustar á með Rík Nærveru

• Niðurhalari: Niðurhalum MP3 beint úr viðmótinu (youtube-dl)

• Veldibundiðrúmmál: Gerir hljóðstyrkssleðann veldisvísis svo það er auðveldara að velja lægra hljóðstyrk.

• Valmynd í Forriti: Gefur börum flott, dökkt útlit

  (sjá þessa færslu ef þú átt í vandræðum með að fá aðgang að valmyndinni eftir að hafa virkjað þessa viðbót og fela valmyndarvalkostinn)

• Scrobbler: Bætir við scrobbling stuðningi fyrir Last.fm og ListenBrainz

• Lumia Stream: Bætir við Lumia Stream stuðningi

• Söngtexti Snilld: Bætir stuðningi við texta fyrir flest lög

• Tónlist Saman: Deila spilunarlista með öðrum. Þegar gestgjafinn spilar lag munu allir aðrir heyra sama lagið

• Leiðsögn: Næsta/Til baka leiðsagnarörvar beint samþættar í viðmótinu, eins og í uppáhalds vafranum þínum

• Engin Google Innskráning: Fjarlægðu Google innskráningarhnappa og tengla úr viðmótinu

• Tilkynningar: Birta tilkynningu þegar lag byrjar að spila (gagnvirkartilkynningar eru fáanlegar á Windows)

• Mynd-í-Mynd: Gerir kleift að skipta forritinu yfir í mynd-í-mynd stillingu

• Spilunarhraði: Hlustaðu hratt, hlustaðu hægt! Bætir við sleða sem stjórnar lagahraðanum

• Nákvæmshljóðstyrkur: Stjórnaðu hljóðstyrknum nákvæmlega með músarhjóli/hraðtökkum, með sérsniðnum HUD og sérsniðnum hljóðstyrksþrepum

• Flýtileiðir (og MPRIS): Leyfir að stilla alþjóðlegarflýtilyklar fyrir spilun (spila/gera hlé/næsta/fyrri) + óvirkja media osd með því að hnekkja miðlunarlyklum + virkja Ctrl/CMD + F til að leita + virkja linux mpris stuðning fyrir miðlunarlyklar + sérsniðnir flýtilyklar fyrir háþróaða notendur

• Slepptu Lögum sem Mislíkuðust: Sleppir mislíkaði lög

• Slepptu Þögnum: Slepptu sjálfkrafa þagnarköflum í lögum

• Styrktarblokk: Sleppur sjálfkrafa hlutum sem ekki eru tónlist, eins og inngangur/lok eða hlutar af tónlistarmyndböndum þar sem lag er ekki að spila

• Miðlunarstýringarverkefnastikunnar: Stjórnaðu spilun frá Windows verkefnastikunni þinni

• Snertistiku: Sérsniðið Snertistikuútlit fyrir macOS

• Tuna OBS: Samþætting við OBS viðbótina Tuna

• Myndbandgæðisbreyting: Leyfir að breyta myndbandgæðum með hnappi á myndbandsyfirlaginu

• Myndbandsrofi: Bætir við hnappi til að skipta á milli myndbands/lagshams. Getur einnig valfrjálst fjarlægt allan myndbandsflipann

• Sjónrænir: Mismunandi tónlist sjónrænir

Þýðing

Þú getur aðstoðað við þýðingar á Hosted Weblate.

Sækja

Þú getur skoðað nýjustu útgáfuna til að finna fljótt nýjustu útgáfuna.

Arch Linux

Settu upp youtube-music-bin pakkann frá AUR. Fyrir AUR uppsetningarleiðbeiningar skaltu skoða þessa wiki síðu.

MacOS

Þú getur sett upp appið með því að nota Homebrew (sjá cask skilgreiningu)

brew install th-ch/youtube-music/youtube-music

Ef þú setur upp forritið handvirkt og færð villu "er skemmd og ekki er hægt að opna það," þegar þú ræsir forritið skaltu keyra eftirfarandi í flugstöðinni:

xattr -cr /Applications/YouTube\ Music.app

Windows

Þú getur notað Scoop pakkastjórnun til að setja upp youtube-music pakkann frá extras fötunni.

scoop bucket add extras
scoop install extras/youtube-music

Að öðrum kosti geturðu notað Winget, Windows 11s opinber CLI pakkastjóri til að setja upp th-ch.YouTubeMusic pakkann.

Athugið: Microsoft Defender SmartScreen gæti lokað uppsetningunni þar sem hún er frá „óþekktum útgefanda“. Þetta er einnig satt fyrir handvirka uppsetningu þegar reynt er að keyra executable(.exe) eftir handvirkt niðurhal hér á github (sama skrá).

winget install th-ch.YouTubeMusic

Hvernig á að setja upp án nettengingar? (í Windows)

• Sæktu *.nsis.7z skrána fyrir arkitektúr tækisins þíns á útgáfusíðu.
  • x64 fyrir 64-bita Windows
  • ia32 fyrir 32-bita Windows
  • arm64 fyrir ARM64 Windows
• Sæktu uppsetningarforrit á útgáfusíðu. (*-Setup.exe)
• Settu þær í sömu möppuna.
• Keyrðu uppsetningarforritið.

Þemu

Þú getur hlaðið CSS skrám til að breyta útliti forritsins (Valkostir > Sjónræn klip > Þemu).

Sum fyrirframskilgreind þemu eru fáanleg á https://github.com/kerichdev/themes-for-ytmdesktop-player.

Þróun

git clone https://github.com/th-ch/youtube-music
cd youtube-music
pnpm install --frozen-lockfile
pnpm dev

Búðu til þín eigin tengiforrit

Með því að nota tengiforrit geturðu:

• vinna með appið - BrowserWindow frá electron er sent til tengiforritsstjórans
• breyttu framhliðinni með því að vinna með HTML/CSS

Er að búa til tengiforrit

Búðu til möppu í src/plugins/YOUR-PLUGIN-NAME:

• index.ts: aðal skránni af tengiforritið

import style from './style.css?inline'; // flytja inn stíl sem inline

import { createPlugin } from '@/utils';

export default createPlugin({
  name: 'Plugin Label',
  restartNeeded: true, // ef gildi er satt, ytmusic sjá endurræsa gluggann
  config: {
    enabled: false,
  }, // sérsniðnastillingar þinn
  stylesheets: [style], // sérsniðnastílinn þinn
  menu: async ({ getConfig, setConfig }) => {
    // Allar *stillingaraðferðir eru umvafnar Lofor<T>
    const config = await getConfig();
    return [
      {
        label: 'menu',
        submenu: [1, 2, 3].map((value) => ({
          label: `value ${value}`,
          type: 'radio',
          checked: config.value === value,
          click() {
            setConfig({ value });
          },
        })),
      },
    ];
  },
  backend: {
    start({ window, ipc }) {
      window.maximize();

      // þú getur tengst við renderer tengiforritið
      ipc.handle('some-event', () => {
        return 'hello';
      });
    },
    // það kviknaði þegar stillingum var breytt
    onConfigChange(newConfig) { /* ... */ },
    // it fired when plugin disabled
    stop(context) { /* ... */ },
  },
  renderer: {
    async start(context) {
      console.log(await context.ipc.invoke('some-event'));
    },
    // Aðeins krókur sem er í boði fyrir renderer
    onPlayerApiReady(api: YoutubePlayer, context: RendererContext) {
      // stilltu stillingar viðbótarinnar auðveldlega
      context.setConfig({ myConfig: api.getVolume() });
    },
    onConfigChange(newConfig) { /* ... */ },
    stop(_context) { /* ... */ },
  },
  preload: {
    async start({ getConfig }) {
      const config = await getConfig();
    },
    onConfigChange(newConfig) {},
    stop(_context) {},
  },
});

Algeng notkunartilvik

• er að sprauta sérsniðnum CSS: búðu til style.css skrá í sömu möppu þá:

// index.ts
import style from './style.css?inline'; // flytja inn stíl sem inline

import { createPlugin } from '@/utils';

export default createPlugin({
  name: 'Plugin Label',
  restartNeeded: true, // ef gildi er satt, ytmusic sjá endurræsa gluggann
  config: {
    enabled: false,
  }, // sérsniðnastillingar þinn
  stylesheets: [style], // sérsniðnastílinn þinn
  renderer() {} // skilgreina renderer krók
});

• Ef þú vilt breyta HTML:

import { createPlugin } from '@/utils';

export default createPlugin({
  name: 'Plugin Label',
  restartNeeded: true, // ef gildi er satt, ytmusic sjá endurræsa gluggann
  config: {
    enabled: false,
  }, // sérsniðnastillingar þinn
  renderer() {
    // Fjarlægðu innskráningarhnappinn
    document.querySelector(".sign-in-link.ytmusic-nav-bar").remove();
  } // skilgreina renderer krók
});

• samskipti á milli að framan og aftan: hægt að gera með því að nota ipcMain eininguna frá electron. Sjá index.ts skrá og dæmi í 'styrktarblokk' tengiforritinu.

Byggja

1. Klóna geymsluna
2. Fylgdu þessa handbók til að setja upp 'pnpm'
3. Keyrðu pnpm install --frozen-lockfile til að setja upp ósjálfstæði
4. Keyrðu pnpm build:OS

• pnpm dist:win - Windows
• pnpm dist:linux - Linux
• pnpm dist:mac - MacOS

Byggir appið fyrir macOS, Linux og Windows, með því að nota electron-builder.

Framleiðsluforskoðun

pnpm start

Prófanir

pnpm test

Notar Playwright til að prófa forritið.

Leyfi

MIT © th-ch

Algengustu Spurningar

Hvers vegna forritavalmynd birtist ekki?

Ef valmöguleikinn „Fela valmynd“ er á - þú getur sýnt valmyndina með alt lyklinum (eða ` [bakka] ef þú notar viðbótina fyrir valmynd í forriti)