Rockbox open source high quality audio player as a Music Player Daemon
mpris
rockbox
mpd
libadwaita
audio
rust
zig
deno
rgnano: rbutil support and manual updates
Needs some testing in windows but except for uninstalling everything should work.
Change-Id: I55691d4cae9b37921f08177edaadc88854fef948
authored by
Hairo R. Carela
and committed by
Solomon Peachy
d695c3b9
e3bb8038
+53
-48
+38
-42
manual/getting_started/installation.tex
+38
-42
manual/getting_started/installation.tex
···
422
422
423
423
\subsection{Automated Installation}
424
424
425
-
\opt{gigabeats,ondavx777,fiiom3k,shanlingq1,erosqnative,rgnano}{
425
+
\opt{gigabeats,ondavx777,fiiom3k,shanlingq1,erosqnative}{
426
426
\note{Rockbox Utility does not currently support the \playertype{} and you will
427
427
therefore need to follow the manual install instructions.}}
428
-
\nopt{erosqnative,rgnano}{
428
+
\nopt{erosqnative}{
429
429
To automatically install Rockbox, download the official installer and
430
430
housekeeping tool \caps{Rockbox Utility}. It allows you to:
431
431
\begin{itemize}
···
538
538
Rockbox website:
539
539
\label{Version}
540
540
Release version, current build and archived daily build. You need to decide which one
541
-
you want to install and get the appropriate version for your \dap{}. \nopt{rgnano}{If you
541
+
you want to install and get the appropriate version for your \dap{}. If you
542
542
select either ``Minimal Installation'' or ``Complete Installation'' from the
543
543
``Quick Start'' tab, then Rockbox Utility will automatically install the
544
544
release version of Rockbox. Using the ``Installation'' tab will allow you
545
-
to select which version you wish to install.}
545
+
to select which version you wish to install.
546
546
547
547
\opt{erosqnative}{
548
548
\note{\textbf{There are two different versions of Rockbox for the \playertype{}. This manual only
···
581
581
582
582
\nopt{erosqnative}{
583
583
The manual installation method is still available to you, should you need or desire it
584
-
by following the instructions below. \nopt{rgnano}{If you have used Rockbox Utility
584
+
by following the instructions below. If you have used Rockbox Utility
585
585
to install Rockbox, then you do not need to follow the next section and can skip
586
-
straight to \reference{ref:finish_install}.}
586
+
straight to \reference{ref:finish_install}.
587
587
}
588
588
589
589
\opt{gigabeats,erosqnative}{\subsubsection{Installing the bootloader}
···
648
648
\opt{gigabeats,fuzeplus}{the main data partition of }%
649
649
\opt{cowond2}{either an SD card or the internal memory of }%
650
650
\opt{ondavx777}{the MicroSD of }%
651
-
\opt{rgnano}{the \fname{Applications} folder of the microSD card of }%
651
+
\opt{rgnano}{the root of the microSD card of }%
652
652
your \dap{}.
653
653
\opt{cowond2}{\note{If you have chosen to extract to the internal memory, it
654
654
will not be possible to save settings.}}
655
655
\end{enumerate}
656
656
657
-
\nopt{rgnano}{
658
657
\note{The entire contents of the \fname{.zip} file should be extracted
659
658
directly to the root of your \daps{} drive. Do not try to
660
659
create a separate directory on your \dap{} for the Rockbox
661
660
files! The \fname{.zip} file already contains the internal
662
-
structure that Rockbox needs.\\}
661
+
structure that Rockbox needs.}
663
662
663
+
\nopt{rgnano}{
664
664
% This has nothing to do with swcodec, just that these players need our own
665
665
% bootloader so we can decide where we want the main binary.
666
-
If the contents of the \fname{.zip} file are extracted correctly, you will
666
+
\\If the contents of the \fname{.zip} file are extracted correctly, you will
667
667
have a directory called \fname{.rockbox}, which contains all the files needed
668
668
by Rockbox, in the main directory of your \daps{} drive.
669
669
}
···
856
856
857
857
\section{Updating Rockbox}
858
858
859
-
\nopt{rgnano}{
860
-
\nopt{erosqnative}{
861
-
Rockbox can be easily updated with Rockbox Utility. You can also update Rockbox
862
-
}
863
-
\opt{erosqnative}{
864
-
The Native Port to \playername{} is not supported by Rockbox Utility yet, so Rockbox Utility cannot update it.
865
-
Rockbox is easily updated
866
-
}
867
-
manually -- download a Rockbox build
868
-
as detailed above, and unzip the build to the root directory
869
-
of your \dap{} as in the manual installation stage. If your unzip
870
-
program asks you whether to overwrite files, choose the ``Yes to all'' option.
871
-
The new build will be installed over your current build.\\
859
+
\nopt{erosqnative}{
860
+
Rockbox can be easily updated with Rockbox Utility. You can also update Rockbox
872
861
}
862
+
\opt{erosqnative}{
863
+
The Native Port to \playername{} is not supported by Rockbox Utility yet, so Rockbox Utility cannot update it.
864
+
Rockbox is easily updated
865
+
}
866
+
manually -- download a Rockbox build
867
+
as detailed above, and unzip the build to the root directory
868
+
of your \dap{} as in the manual installation stage. If your unzip
869
+
program asks you whether to overwrite files, choose the ``Yes to all'' option.
870
+
The new build will be installed over your current build.\\
873
871
874
872
\opt{gigabeats}{
875
873
\note{When your \dap{} is in the Rockbox USB or bootloader
···
884
882
need to be updated.\\
885
883
}
886
884
887
-
\nopt{erosqnative,rgnano}{
885
+
\nopt{erosqnative}{
888
886
\note{If you use Rockbox Utility be aware that it cannot detect manually
889
-
installed components.}
887
+
installed components.\\}
890
888
}
891
889
892
890
\opt{rgnano}{
893
-
Rockbox can be easily updated by replacing the \fname{rockbox-funkey-s.opk}
891
+
Rockbox also can be updated manually by replacing the \fname{rockbox-funkey-s.opk}
894
892
file in the \fname{Applications} folder of the microSD card with a newer version.
895
893
}
896
894
897
895
\section{Uninstalling Rockbox}\index{Installation!uninstall}
898
896
899
-
\nopt{rgnano}{
900
-
\nopt{gigabeatf,iaudiom3,iaudiom5,iaudiox5,mrobe100,gigabeats,fuzeplus,erosqnative}{
901
-
\note{The Rockbox bootloader allows you to choose between Rockbox and
902
-
the original firmware. (See \reference{ref:Dualboot} for more information.)}
903
-
}
904
-
905
-
\subsection{Automatic Uninstallation}
906
-
\opt{gigabeats,erosqnative}{\note{Rockbox can only be uninstalled manually from the \playername{} for now.}}
897
+
\nopt{gigabeatf,iaudiom3,iaudiom5,iaudiox5,mrobe100,gigabeats,fuzeplus,erosqnative,rgnano}{
898
+
\note{The Rockbox bootloader allows you to choose between Rockbox and
899
+
the original firmware. (See \reference{ref:Dualboot} for more information.)}
900
+
}
907
901
908
-
\nopt{erosqnative}{
909
-
You can uninstall Rockbox automatically by using Rockbox Utility. If you
910
-
installed Rockbox manually you can still use Rockbox Utility for uninstallation
911
-
but will not be able to do this selectively.
912
-
}
902
+
\subsection{Automatic Uninstallation}
903
+
\opt{gigabeats,erosqnative,rgnano}{\note{Rockbox can only be uninstalled manually from the \playername{} for now.}}
913
904
914
-
\opt{iriverh100,iriverh300,fuzeplus}{\note{Rockbox Utility cannot uninstall the bootloader due to
915
-
the fact that it requires a flashing procedure. To uninstall the bootloader
916
-
completely follow the manual uninstallation instructions below.}}
905
+
\nopt{erosqnative,rgnano}{
906
+
You can uninstall Rockbox automatically by using Rockbox Utility. If you
907
+
installed Rockbox manually you can still use Rockbox Utility for uninstallation
908
+
but will not be able to do this selectively.
917
909
}
910
+
911
+
\opt{iriverh100,iriverh300,fuzeplus}{\note{Rockbox Utility cannot uninstall the bootloader due to
912
+
the fact that it requires a flashing procedure. To uninstall the bootloader
913
+
completely follow the manual uninstallation instructions below.}}
918
914
919
915
\subsection{Manual Uninstallation}
920
916
+15
-6
packaging/rgnano/rgnano.make
+15
-6
packaging/rgnano/rgnano.make
···
2
2
MKSQUASHFS=$(FUNKEY_SDK_PATH)/bin/mksquashfs
3
3
INSTALL_DIR=$(OPK_BUILD_DIR)/install
4
4
OPK_BUILD_DIR=opkdir
5
-
6
-
opkdir:
7
-
mkdir $(OPK_BUILD_DIR)
5
+
OPK_NAME=rockbox_funkey-s.opk
8
6
9
7
opkclean:
10
8
rm -rf $(OPK_BUILD_DIR)
11
9
12
-
opk: opkclean opkdir $(MKSQUASHFS) build
10
+
opk: opkclean $(MKSQUASHFS) build
11
+
mkdir $(OPK_BUILD_DIR)
12
+
13
13
make PREFIX=$(OPK_BUILD_DIR)/rockbox install
14
14
15
15
# Install opk files
···
37
37
chmod +x $(OPK_BUILD_DIR)/run.sh
38
38
39
39
# Make opk
40
-
$(MKSQUASHFS) $(OPK_BUILD_DIR) rockbox_funkey-s.opk -all-root -noappend -no-exports -no-xattrs
40
+
$(MKSQUASHFS) $(OPK_BUILD_DIR) $(OPK_NAME) -all-root -noappend -no-exports -no-xattrs
41
41
42
42
opk-zip: opk
43
-
zip -9 -q rockbox-opk.zip rockbox_funkey-s.opk rockbox-info.txt
43
+
mkdir Applications
44
+
mkdir -p FunKey/.rockbox
45
+
46
+
mv $(OPK_NAME) Applications/$(OPK_NAME)
47
+
48
+
zip -9 -q rockbox-opk.zip Applications/$(OPK_NAME) FunKey/.rockbox rockbox-info.txt
49
+
50
+
mv Applications/$(OPK_NAME) $(OPK_NAME)
51
+
rmdir Applications
52
+
rmdir FunKey/.rockbox