From 0d0a12f5516254acd8be81fb97cd7694e9010d21 Mon Sep 17 00:00:00 2001 From: Ayush Sehrawat <69469790+AyushSehrawat@users.noreply.github.com> Date: Wed, 24 Jan 2024 23:15:08 +0530 Subject: [PATCH] docs: minor improvements (#160) * docs: readme improvements * docs: readme improvements --- README.md | 99 +++++++++++++++++++++++++-------------- assets/iceberg-dark.png | Bin 0 -> 3831 bytes assets/iceberg-light.png | Bin 0 -> 7116 bytes 3 files changed, 64 insertions(+), 35 deletions(-) create mode 100644 assets/iceberg-dark.png create mode 100644 assets/iceberg-light.png diff --git a/README.md b/README.md index e854399b..fbeeb10c 100644 --- a/README.md +++ b/README.md @@ -1,19 +1,35 @@ -# Iceberg - -Plex torrent streaming through Real Debrid and 3rd party services like Overseerr, Mdblist, etc. - -Rewrite of [plex_debrid](/~https://github.com/itsToggle/plex_debrid) project. + + + + Iceberg + + + +
+ GitHub Repo stars + Issues + License + Contributors + Discord +
+ +
+

Plex torrent streaming through Real Debrid and 3rd party services like Overseerr, Mdblist, etc.

+

Rewrite of plex_debrid project.

+
Services currently supported: -- [x] Real Debrid -- [x] Plex -- [x] Overseerr -- [x] Mdblist -- [x] Plex Watchlist RSS -- [x] Torrentio -- [x] Orionoid -- [x] Jackett -- [ ] and more to come! + +- [x] Real Debrid +- [x] Plex +- [x] Overseerr +- [x] Mdblist +- [x] Plex Watchlist RSS +- [x] Torrentio +- [x] Orionoid +- [x] Jackett +- [x] Listrr +- [ ] and more to come! Check out out [Project Board](/~https://github.com/users/dreulavelle/projects/2) to stay informed! @@ -24,12 +40,13 @@ We are constantly adding features and improvements as we go along and squashing --- ## Table of Contents -- [Docker Compose](#docker-compose) - - [What is ORIGIN ?](#what-is-origin-) -- [Running outside of Docker](#running-outside-of-docker) -- [Symlinking settings](#symlinking-settings) -- [Development](#development) - - [Development without `make`](#development-without-make) + +- [Docker Compose](#docker-compose) + - [What is ORIGIN ?](#what-is-origin-) +- [Running outside of Docker](#running-outside-of-docker) +- [Symlinking settings](#symlinking-settings) +- [Development](#development) + - [Development without `make`](#development-without-make) --- @@ -38,26 +55,27 @@ We are constantly adding features and improvements as we go along and squashing Create a `docker-compose.yml` file with the following contents: ```yml -version: '3.8' +version: "3.8" services: - iceberg: - image: spoked/iceberg:latest - container_name: Iceberg - restart: unless-stopped - environment: - PUID: "1000" - PGID: "1000" - ORIGIN: "http://localhost:3000" # read below for more info - ports: - - "3000:3000" - volumes: - - ./data:/iceberg/data + iceberg: + image: spoked/iceberg:latest + container_name: Iceberg + restart: unless-stopped + environment: + PUID: "1000" + PGID: "1000" + ORIGIN: "http://localhost:3000" # read below for more info + ports: + - "3000:3000" + volumes: + - ./data:/iceberg/data ``` Then run `docker compose up -d` to start the container in the background. You can then access the web interface at `http://localhost:3000` or whatever port and origin you set in the `docker-compose.yml` file. #### What is ORIGIN ? + `ORIGIN` is the URL of the frontend on which you will access it from anywhere. If you are hosting Iceberg on a vps with IP address `134.32.24.44` then you will need to set the `ORIGIN` to `http://134.32.24.44:3000` (no trailing slash). Similarly, if using a domain name, you will need to set the `ORIGIN` to `http://iceberg.mydomain.com:3000` (no trailing slash). If you change the port in the `docker-compose.yml` file, you will need to change it in the `ORIGIN` as well. ## Running outside of Docker @@ -78,6 +96,7 @@ npm install npm run build ORIGIN=http://localhost:3000 node build ``` + Read above for more info on `ORIGIN`. #### Second terminal: @@ -90,11 +109,13 @@ python backend/main.py --- ## Symlinking settings + "host_mount" should point to your rclone mount that has your torrents on your host, if you are using native webdav set webdav-url to "https://dav.real-debrid.com/torrents" "container_mount" should point to the location of the mount in plex container ### Example: + Rclone is mounted to /iceberg/vfs on your host machine -> settings should have: "host_mount": "/iceberg/vfs" Plex container volume configuration for rclone mount is "/iceberg/vfs:/media/vfs" -> settings should have: "container_mount": "/media/vfs" @@ -104,6 +125,7 @@ Plex libraries you want to add to sections: movies -> /media/library/movies, sho --- ## Development + You can view the readme in `make` to get started! ```sh @@ -111,16 +133,17 @@ make ``` To get started you can simply do this. This will stop any previous Iceberg containers and remove previous image. -As well as rebuild the image using cached layers. If your a developer, then any files changed in the code will not get cached, +As well as rebuild the image using cached layers. If your a developer, then any files changed in the code will not get cached, and thus rebuilt in the image. ```sh make start ``` -You can also restart the container with `make restart`, or view the logs with `make logs`. +You can also restart the container with `make restart`, or view the logs with `make logs`. ### Development without `make` + If you don't want to use `make` and docker, you can use the following commands to run development environment. ```sh @@ -137,11 +160,17 @@ npm run dev --- ## Contributing + Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. We use Black for backend and Prettier for frontend. Please make sure to run the formatters before submitting a pull request. Also use CRLF line endings unless it is a shell script or something that requires LF line endings. + + + + --- ## License + This project is licensed under the GNU GPLv3 License - see the [LICENSE](LICENSE) file for details diff --git a/assets/iceberg-dark.png b/assets/iceberg-dark.png new file mode 100644 index 0000000000000000000000000000000000000000..f1cf2d3576a9cf98f1c9f341a57b050e70cfcd66 GIT binary patch literal 3831 zcmbtX_g@p~`h6!u1|-4gsw6aH0|5n$N)=4jhF}2$Hi`t}N(~^e1Qp4!SH*i3Z0y2P zB)Ucs3sD3SP)00RAtF^N!9r7t8#*L&XT10R1K;lt`OM^f&U?;z&ht(_nSXk2b=A`~ z)CB2LK{&A)td07r*Gd{lsNj)W+R00OTAZKTv=062h5A7%rRMN|3hC<2)Pa`bjOva2g z>o?8c=o!IA4(E=v9BFh6y7{27@B+JiG)(6(H%Kby(jKezk!cr*-=zWl_Bl zY)mo$d;x;a&Vc4o_x~TiHn|kp2(&C@hm*vB0W+XRl$lgO$$jA{x&QHt8`C{;$>4Xs zdn0<9!lv|Be3s>EUm$9s=V|BnF9)e<{0UR#Zsj9tWEqq&uWKr2`A$>~*AMe}b%ujK{!fcf2WD_%VdsM7NA zt|N1GB%H5Jz}EQ0bYSD;H~JE?O&?ndo`;F9-VY3)<;FlaSXx}_Q1@*EtJ z{L6}$bqDghG}wdBuA$tufR)iQ5BzGpD=&)!tancQ2l1V*q!?Y$czj>V%aTKWH#Vrb zLYl%X959>4ejuJU12b<2b?#o8=K%z}n>ma-59s8X!vdd_ceq6{nDfN|OL}<~_j0Cr za_rDmMSQ%biQ;`qPsxLc)o{qN5{cTn@V~d9#6Ro@L-4N%*5~6$@+x|r;ifRsaS$|% z?>>6RsC6zfmvRfTp#)G@pO4W*KYbPUo|wOMzV8uLjYaiC+iqcz&1I^EEDUpPRzJHk zX>+i(D=8?tI`@6=`$K_n(|hu~$X^^B!!^ zcXv@AWD3Ezy9pCq(|xq2NKFOO7WI*Ty2E4+wgRoaigPcw{2Z27h|aOc|HK1F+iivp zqIyz4b;Z;EqorxftfW|{_SiI~ddaOuQy8@E3~sG~BwABp7l-F#yD<$G+4n~B4CEbw zZ0977;LX{pB^X=ZhmA;_qAJF@ZhyXE3qyeZPu>Z((U&58f4B-L564F1`1*ll$(2iFEt12Q<&IA-pGBwYXY+qYSm7 za08SAPM`yA?$h!=JuV~n;zn4niy^)x`X3bat$iusQFReR4wN_dN&8MKq zS3D`u2LoAbN(!`%BCVfboO(w=nx}%+oPr*=Q}fi{aK8tV4bqQ=>UOxzThKZqSMP)Z z`shnLSGg}<7s@TLVPs8%7yAng!#MAEeZ_}P zZWTw6)ImWH^m09~Qe(@wddER z(&RS-tf(Ywc;4V+E;GN5Qra}t<$xG>F9+yVxyGaU@B643W9pWY6(wy1tdT6q*4rI1 z&`tK(mS}p3mlzVLEBHNyXj>>gzY2{hr2%Jkg?9(BV9#|xTCOw_7PFEi`%9)zeRvr* z;-G4O#8JliQ+XZ9k_~w{cHK%jy2CGexS;>mjk?_7RihHuvbWoTXR)T;TpnTT*i`{( z_8ya!IuDkuxyDgOC|^*%>c10$v}Huh17cLNxPvP2(nf7@{@7=q zRE12Y6yXG@==K>QuMk3q13u_FB6p2JgG6N3%Tnwk3EWCJ(iZ@mC~&Gwfo>uMDC?vH zvXV)Fw(Ez|gRKej>$g0GypzNjciO&vhF+l%=nY2=;7naYC3I~DM_NRJN;e95D@c%# z`0;w9MGzF3K4B^Ngi8G>b0KdQS^Mia8_v`r_q`hw@|KWGF$+#X^)SKtOwR@JCff`B zpb+wCWUX)m8_p+9<*?%Dd96gP_mN!4>m&6JE<6p@lU}Onj!0cNp*OtmIY+vm)Jxe` zg<6sXSC1RPp|(UUhgP<*JeQCJ)hC2lCt2${ZU~32Bx`ncEYF2xtsz*5T_I|X^Nt(9 z#SsK&iXej{_)6*>UYG)9Q3)^qFxX3Px&!UPZO_erhFX!<15YhS!ha&*dij$a!F7aS zI8n-mi**V1<0~pzp3VfjpVl+^%Ig(1p!NrrV5dX6O6SZWNrleq*AIU%#B5h}m+M$pac3G~16 z$~aPQl5Oj0A=XPa8s(n?nHm!4v%lIRX*vYDvR6dkWlNxcQoLo!<6yaFlSv8`rcGcv zhF2mt^a=eQJO5Kqm>q#0%Cvrl+7f-*^bIdZZjgP3@Kr+0hp=MPdTpE|xJkI%q2%KuFfzeJaFii7BSPFN&w{G6Wvh2@fudT#7zFEp$cGYQH8$ z!jTRiFD(*%(#Eo4s<|1ekEVJ`W|V5v&BHEb51d||1H07X^P4O`F7A35} zDw(eIU_RVaTdd#rR(6`QSjk2McE@i!_j1xz*-+uZOb+Q`hrL(_8Opap}%leya{{b4%7R#~5+i-zB** ynhGzbpD9>09Fh{iu)gN?|9oZp-|L=QM_u-7Q>^(AbS7OJRiU`%(y#J=vEmStc4wWG_lJ*OF*e_H`^}7e%t0D3PKP zNm*jDlq{17WA1OhzrXIi@44^!ob$ftdCxh|lWK2k!No4h4gdhx2}@H)005b~sVz@ZoUr>foR zlHj6BXDn*}#Kg&ZE8Dfc*wdf(t173MzartT3uuqpzt}jadh@&ud$~OwFDKw@$!p}W z{>!>?dTXz9VQ)Nc*h4eef9!4Tv<)u6aO_xcT|kj`+~zg04QD)~AzBS{*M{!fJ=l$c~(}1azhR<|5M1JpkD)Zr#zUvV*VZBzT z@2%P^OtcAbLYV(c;<(a)z^@QYhA9PuV?FPeApGgUuJG~zZxI&(jk{NMClI5Rh}T3D zmZz<)b4w1OCsM}!F@%E3b5h|ue=Ov`NiC!<@290>@fgY77?WZ@^ld=zq6#S}w^^i1 za;%IOG6$~1%|V>t9Za-2(3}{=`7~cAm(;Xfp#r)c3%qqB`S%mT%?NKVDCNocjxdxA z3o~7O?I-ZbFe^INDzFHM^$T=+_Jx2EhOn3%CuncIjS^{80QvagOKJh}^pDr(#jDSAmKw1)Crj42ox?AT&-0_A$% zv#YNG@AHpfbcT+(5;HEG)Q+utVC;dila));Ovi)goN3eTAJ`_9r0cizWr0??wW(?D z8F}D2rj05);)Her6H+GZmC$;!@CBu#8#A5cqQ9h@*H!A)EefL~O0=JyN`{pn6Ml+l zMg^7GYP&Ms6HopZJ>$s|o|Ecl|EgI`rRq>#q|*VAx4}9ckrq`G#IGf4-?v~66Am)p zCh4{pvhdRFJ5SVT_`eF30*sws^^?nCN=l!V~4zL3!u zzbMkc)Qmw(e;i4Wl6ZZrbj2HAav{B3M0LlqL0a46FkljgT7E>A75gF6>O1nq8LyWt zXpWQSC^^B>D>UU@eful7a;vauhO#-3bcC&a9k<_plUWpueAVIl3?fass0lYl#puw1eoh=q;nRV=Y1V zs^BDw%ILGd>KP9u`q7hnjuPU7lQt5nUy~278a^b_=77h#O07L44pw zg0&P4;aw?lfwvgL0G%J6zLoMq7W6!^tE;oq$9Kl(gNixub@CzghLOy{W3}vSQ{DU& zA)o{1q_#%qU;DB2d#H8#{_Dl25-cSPc#Mjzv64{zEY@2ES5kd0{zMJ6l2SG=$sQua zLj6hziDPDL5qEmE(u##TwC_8WoVNFUB|G?)n(o)FcK!)Wbb~YbfOo#Uo^us^F!-C;zpM9M{)}+7 zt`xN2nCj@xGU3PjZJ?NbV1lY_OLP&$dm%1HTmDwD0jrH5d2eytoBy8JQaR%S2sy&1)f7 z(e{|F+x3iVk z9;vsFqN~awxxVWYXRmw`%DcR?b!HHjWGjA1cddeK9ZQ?#DqH^e98zB%fgRWgn;S-* z0AM;=K<%XRehGq)jYzHI@#f3KgIZfk-H|8z#~L z@^#5_D04}8nP#Moi95yc?y5K4HRlm=TGZEjUB2* z%kECRZ*po&Ql5nSzI0C>7>aak^tpQbU)`RKz&qP=b4D{`7qZt{nNV`ya4BvK% zRcdd?peYKdoQa2DE5K58n)qgM?oGdgnZaTIyd(<=)!?&1r7KEo?&NSA+Bkf#7=(;XG3Zui<=OVz+NB&ZC+D;V5W zA-6igq#vZCL9q(B>Y>~{Z#bH!sdUTsnj)%aJ$jpnTi{Sl-}lU$!y(075in zzoI%502J+;p`SGTcvnw+m2@%euYsaASFqHK-Gqw>NiN@#3n>J0(R)I z>w6VGl|fe2!d+SWi45+p$8X?G3_&tQ+lw)f8xX00Kc;?ka43(i4-q;KP}IfoM~HYk zbojL$RsJ~zD#?xMCqkWIRqP_o0UdV%{}geXH8;~S*|VMO4CRQsy^2M>i% z!3$gD%`-R`8bZz3y$Xo4x5``{;eLnT*_s_7d$J~FkD7_R?|>{HAdO#tVU??o?uB`> zIG_A4jY_AO72@ZDgDoOt2|t8-&ZO0ujZ&X$;FdpIp?P&~Px$`LUkloC?R=>iuAlZZ zx%J}g5xVc4^(h}zxJ)x*W%O5_&m+nUvJ`-3X^61$GaAWnp1XZi779WO-zC|3*Q)H=nb`Q2xs{~oWhW$k zynh@J(Ks4mxqG5g8J^nhhSu(-h8JD9H!d{V&k*5j(3o-55r;>VK+A?5tDeOyL^io% ziX+8xLwB)9zx(}TL6hk38aV$?HstdEV}g&zgGzcMT51wnKF3hP%jM@bUr#6N7DxYi zd!Wxsq*%sy9$RMx$lK0)GS18=O)$5C*hkfHtk1tNROlbY&UL?xr64=hP(`# z+^O$w!Bz|jl>kRjJXVhCeEj7n=7Rl)E@Dkeoa=bSYU3|bY$2HBE5mw!`RZi`&5k|x z`YKDM!P@Dbw9~9=sZWPS;0*Y~mI`o3M3+WRwM(ZV&Mfv*Si)@NL`PL2f|iIA4F^)J zSQ^Yxp8Eq>FE`SV$U>GOD9?t$CdF(kz$&oe!pBGZYPz-5d#SP>e{N561nMy>3c-hc zBI$z;{$I9hX(Mmk;Y?6JJnso+lzpv)M=Z=39|t z)i&p)_o0h#Jz8jZ){b->+nnkapg3!E7JZI#61OG#&JGP1J#*XFF3@zntrD^<5iX(! zXkKy{vwabtFFCb4y>Bi2RugS2+V|m9akoK7#8qu96*j9+S7Rzkhe?I5!kf487dd@i(9YB z6u7uUo?ZH_xh90lF_hX21xTDTJQqzE67W*hi?Wg6S3|92S=&+57)2C&Ht@vZer{cU zH=Y01uf;tLLoPzs0o-r4Hs26qF!0h}*9jYgI~F{;1~tqnLX<7gTIRuq4?hvFhz@5o z`e>}2W2|&@a!TFSuybgA1Mqluhp&kL?yr^w(vb-hx$LV%EwgSS@J_V`ZQsWduNkze z=)?E`L+^6OZr;N?5%J0PA;-aJRYdb&CYcSjm7|Orw@VKIosny)=ODFhqwrJvJ$L$v zFgxTn0Seh6Cd&tRVv6GjjaW1ZYgOEXaQI@wi#Fz!B4E7xo}=adY8)(MIow5;S`gFU z3wRwdEf#6Ol{57!{3e;T@~TKbl{C#(asEOu5kK4IwC(s_@8dZ^nEr#@dBBDdJZQ+W zsr6S2&#U?l9Ui_z?tk$b&ZP@+78fOpKH;=K0USo+tZFWfY0QoQb?CIewBhSf!wq)C zuc>~G87Y*d<5W{ ziSW7t5p}e{rc391j1vhLl^12BP)WwX>Ce$aet{uU}15~Joihx;Jqml74YJBaS<48kfc%&c^4+AudvH^rp{3#f> za%~-K^y7DBO?&I;!0PPE4E2c@j*lGTmK1o>H%8#}o|4NV#qq%MO81p-6DbLpjVtn% z3SbUh=(ghlg#(a5Hu#JUPo)jtUT8Pm8{WU9v!(=nBvJ;XT?XL^G=Vn#Kn04Atl-bq ze07Wqr&9ZK1ki;DI}cmv0TUL{McN0@@r@d|ZBdGNOSK(}ih)Hi7k7ryZ}VKu@THt? z-*2BI;%y+p0EzWG_n%1;zcx{~@rx@X&ozfG_>T0K#&uVFc;=V>9_PG?qk085X{1C|zYu!{B}IJ8w%! z0?QjdJ;(3dmV6>|Lg`tyMzJ(FzSM0>{UUshx6+H%5^zXjUIdVy1RI6~81>X*|5uG$ zHqzLwLw*};T7)7X>1wMIB85gC{c85IVcbf3%Egz6=ONtZ1MQ0b5tt8+i`hbi52Yh~*bqNy$+T9^mTBGWIfuDx?_@9p zGluLsv1HKb#QK@SeR!Oo$eQ-Tx6A@w6+YOMEr4cJ@hc=m8Pi19!qq^<-i*|6W(G0u zE4`%q$$G9lzo~<;6tTdbHOU}1|G$~~CEb`aE*q^r|3DEn^k%k}h}U68yI#+GpT=X( zug^SKsnWn`1w!nZJvMyq-Pa3!ihxTO=TVxQu}H(pB@rkm0^TxYMna*)&*f|d;uR3p zeyc1Kbg=7snh9#4!)F_>&`7AF$-S^67H!QPuQYH%U}YBKWl^I1SQPp|1Z)J(%A+E& z_&mDL#gYN!-1qbRPQ1mLV8;D&9gDYVk2rZ{0o`qq)vd!w)fvCv+*r9d<9_Cu{xlM* z?LNiTf1HUWWz-Eb*p;;bL+Ekt;QYVo1{dk{Kl7G25*PliK7IDTqk8`U@&#WVx8rl_ zgvVhAto@>pw+P;AvAi%=1ZTtS#huaAXK;w3h|0mlep^+cdSkN=1M1r(N3kzUMw+%` z`HJ6k_{SacL$`7?Krd zHre{Kv?kSpMR5PL@Q%!khv}Vt7aN40e*IYCbW$N>t3VP}YqL87pM~BlBd1f; z(j}B*<;To_6Ja#iq>T6(1n+Tz5cGrytT(7_PXcVvdr9QHluVLeWoo>zvE2N$b~bo| zSv`ynAFLe?#H_smW~aJY)VC*L=l>w*q4o9h7tG5n@MY?QH%t@LJJr&?Q5TJQN`C*c z!OMd1gp+XoUt^TC7yHe_z)gBZ-T7vh*&h-d7AAz9Ys)J&9_*BvOi(Ftco67obHY%l zMuT=^v1ieNMBw~j!3*^^PD@Et}20^ENi$J4d2~*=%4zNI&DQ5-=wBYIK3p#_as&Xjyd~Ox0*9WhS?{X z?RH7B7yFx+gh@X+?Yp&3(H=7G=3{{lcBpZ5nmeQMRLC8RWYGHY;f$E=CN#lmc&;1RhKJ?w<{+qtzPdJaNT=`0=wSN&HQNiy{;p zux~Z&+yAN7rlezRZCU%zHj6@kFb#tMD;RQZUHbD6iKt3RyeVbz81TtTB>b9L+DQOm zpAj#u_@w0|s8M~}VeXJja=)HzsMfjqR~KvR1Mjm@;t=}epKYPVwf%x}Vq;TH386}qi4^xb1LpQ#eDC2(yA)- zZ;qG30n*WwKgNmTNSv8)WwH+8&;|MP&B483YpsCz){%A-ijSl3cNpj)W7nq;4mie< zb?lqDaQM5E%KrIhJUD+&n%+twF{yNwYVETuYFvw*Bvp9WX`fwK_Wn~roxNiV;zl9I zca?jDlTSC@OIT!QeAC@x`I+JgsRwf;un;|N`gDE7SWl-0mlJUH; z5ksheyiqf3fa*X4aNwy0x(Q3xh`akX_4)4rfbmjy%gYw?gpFVU{m1DO^n`EI^*w{= z)l#xy&H0job8RaQ`P}rW-v#YMX0kVdi_&YX01v7qQNL<_^MdiCq1wE?_hsjEJLug2 zqepkk=U2`<37Q2zs&OOR={bZ&%t2Bw~j4 z4vi&9LoEfL;z&#iwgQC#VxXLqlHG19=L*Q_7&*zYGkydA=d%=$0!#nsC=CD{!8d z$entmf(=UXDf(+|OyMis=aU#K0W{!UGO<}XJ348;_0z9h0=P}XODG2IR XLsGd}@BWuec@8*XW^4M`n2_*4v%U?s literal 0 HcmV?d00001