5 Commits
Author SHA1 Message Date
tuxgyver 53f5fc1148 Le serveur se présente, et range son jeton (2.3.0)
L'interface du serveur affichait un champ de jeton dans son en-tête, visible
en permanence alors qu'il ne sert qu'une fois : il descend dans l'onglet
Réglages, avec le nom du serveur, sa version et le nombre d'appareils
appairés.

Elle gagne surtout une page À propos sur le modèle des autres projets : cinq
sections, contenu séparé du rendu, version lue de /api/health et journal servi
depuis le CHANGELOG du dépôt — rien de recopié, donc rien qui puisse diverger.

Au passage, le serveur annonçait 1.0.0 depuis six publications ; il lit
maintenant le fichier VERSION comme le client.
2026-09-13 22:10:44 +02:00
tuxgyver 28cb545685 Un jeton par appareil, révocable seul (2.2.0)
Tous les appareils partageaient le jeton du serveur : perdre un téléphone
obligeait à changer ce jeton, donc à réappairer tout le monde. Chaque
appairage émet désormais le sien.

Révoquer devient une opération locale, vérifiée en appairant deux appareils
puis en coupant le premier : 401 pour lui, 200 pour l'autre, jeton maître
intact. L'interface du serveur les liste avec leur modèle, leur date
d'appairage et leur dernière synchronisation — sans jamais afficher les jetons
eux-mêmes, ce qui reviendrait à les distribuer.

La table s'ajoute sans toucher aux données existantes et le jeton maître reste
accepté : rien ne casse pour un appareil appairé avant cette version.
2026-09-13 21:23:19 +02:00
tuxgyver 51b60cda70 Appairage du téléphone, en-têtes de licence (2.1.0)
Recopier un jeton de trente-trois caractères sur un clavier tactile n'était pas
un réglage, c'était une corvée. On ouvre désormais une fenêtre depuis le
serveur, on appuie sur Appairer côté téléphone, et c'est fait.

Le jeton n'est pas pour autant distribué : ouvrir la fenêtre l'exige déjà,
elle dure deux minutes, se referme dès qu'un appareil s'est servi, et ne
répond qu'à une adresse privée. Le champ de saisie reste là pour qui préfère
le coller.

Les cinquante fichiers de code portent en outre leur notice de licence, comme
la GPL le recommande. Elle est en français, comme le reste ; le texte qui fait
foi demeure celui de LICENSE, non traduit.
2026-09-13 20:15:14 +02:00
tuxgyver b3ddc2117b Noxely passe sous licence GPL v3 (2.0.1)
Le dépôt annonçait une licence « à définir », et la page À propos le signalait
en rouge. C'est désormais la GNU GPL v3.

Le texte est copié de la référence système plutôt que retranscrit : une licence
altérée, même par inadvertance, ne vaut rien. Le README en expose la portée, y
compris ce que la GPL implique pour qui redistribue une version modifiée.

La page À propos porte la licence et le copyright dans son onglet Auteur, et sa
pastille passe au vert.
2026-09-13 19:08:27 +02:00
tuxgyver ed1d40826b Noxely se sépare en client et serveur (2.0.0)
Le téléphone balayait quarante radios toutes les trois minutes, cherchait dans
quatre catalogues et enregistrait des directs. Tout cela le tenait éveillé pour
un travail qui n'a aucune raison de se faire sur batterie.

Un serveur reprend la collecte : recherche, guet, enregistrement, file de
téléchargement, piloté depuis un navigateur. Le mobile demande ce qui a changé
depuis son curseur, télécharge et se rendort — toutes les six heures, en Wi-Fi
non facturé. Vingt fichiers quittent l'application au passage.

Le balayage devient continu plutôt qu'espacé de trois minutes : une sonde ne lit
que le premier bloc de métadonnées avant de refermer, ce qui rend la permanence
tenable quand garder les flux ouverts coûterait plusieurs mégabits par seconde.
Un morceau guetté a été capté en moins de vingt-cinq secondes. La recherche
interroge les quatre catalogues à la fois et fond leurs résultats, les plus
légers d'abord.

Quatre défauts corrigés en chemin, tous trouvés en essayant plutôt qu'en
relisant : un jeton régénéré à chaque démarrage, qui aurait obligé à
reconfigurer le mobile ; un 403 de Wikimedia dû à un agent trop générique, que
la fusion des sources masquait ; un dossier de données par défaut inaccessible
au compte qui lance le serveur ; et une lecture de métadonnées qui n'itérait
rien, faute d'être asynchrone.
2026-09-13 17:39:43 +02:00
82 changed files with 3886 additions and 3623 deletions

No files matched your search

+4
View File
@@ -14,3 +14,7 @@ keystore.properties
*.apk
update-token.properties
app/src/main/assets/CHANGELOG.md
server/venv/
server/data/
server/.env
server/**/__pycache__/
+136
View File
@@ -5,6 +5,142 @@ Toutes les évolutions notables de Noxely sont documentées ici.
Le format suit [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/)
et le versionnage [SemVer](https://semver.org/lang/fr/).
## [2.3.0] — 2026-09-13
### Ajouté
- **Page « À propos » du serveur.** Un onglet `ℹ️ À propos` avec en-tête d'identité et cinq
sections : ce que le serveur fait, ce qu'il garantit, avec quoi il est construit, ce qui a
changé, et qui en répond. Le contenu vit dans un module de constantes séparé du rendu.
- Le journal est **lu** et non recopié : une route `/api/changelog` sert le `CHANGELOG.md` du
dépôt, que la page interprète pour ce qu'il emploie réellement — titres, puces et gras.
### Modifié
- **Le champ « jeton » quitte l'en-tête du serveur**, où il n'avait rien à faire, pour l'onglet
`⚙️ Réglages`. Une carte y donne aussi le nom du serveur, sa version et le nombre d'appareils
appairés. Sans jeton connu, la pastille d'état indique où le saisir.
- **Le serveur annonce la version du dépôt.** Il lisait une constante figée à `1.0.0`, restée en
arrière de six publications ; il lit maintenant le fichier `VERSION`, comme le client.
### Corrigé
- `saveToken()` relançait l'amorçage du jeton au lieu de rafraîchir la page : un bloc y avait été
déplacé par erreur lors d'une édition antérieure.
- Une garantie annoncée à tort. La page affirmait que toute route hors `/api/health` exigeait un
jeton ; la page elle-même, ses ressources et le journal répondent sans. Les sept garanties ont
été confrontées au code une à une, celle-ci reformulée.
## [2.2.0] — 2026-09-13
### Ajouté
- **Un jeton par appareil.** Chaque appairage émet désormais sa propre valeur, au lieu de
distribuer le jeton maître. Révoquer un téléphone perdu n'atteint plus les autres : vérifié en
appairant deux appareils, en révoquant le premier, et en constatant que le second continue de
se synchroniser (401 pour l'un, 200 pour l'autre, jeton maître intact).
- **Onglet « Appareils »** dans l'interface du serveur : nom du modèle, date d'appairage,
dernière synchronisation — ou « jamais synchronisé » —, et révocation d'un clic.
- Le téléphone s'annonce par son modèle lors de l'appairage : un appareil qu'on ne sait pas
nommer ne se révoque pas.
### Sécurité
- Les jetons d'appareil ne sont **jamais renvoyés** par la route qui les liste : les afficher
reviendrait à les distribuer.
- La date de dernière utilisation est enregistrée à chaque appel authentifié, ce qui permet de
repérer un appareil oublié.
### Compatibilité
- La table s'ajoute sans toucher aux données existantes, et le jeton maître reste accepté : un
appareil appairé avant cette version garde l'accès. Le réappairer lui donnera un jeton propre,
et donc une révocation individuelle.
## [2.1.0] — 2026-09-13
### Ajouté
- **Appairage du téléphone.** Plus de jeton à recopier : on ouvre une fenêtre depuis l'interface
du serveur, on appuie sur « Appairer » dans Réglages ▸ Connexion, et l'application reçoit le
jeton. Le champ de saisie reste disponible pour qui préfère le coller à la main.
Le téléphone ne peut pas deviner un jeton — c'est ce qu'il protège — mais il peut le recevoir,
sous trois conditions cumulées : ouvrir la fenêtre exige déjà le jeton, elle expire au bout de
deux minutes, et elle se referme dès qu'un appareil s'est servi. La demande doit en outre venir
d'une adresse privée : un appairage n'est jamais joignable depuis Internet.
- En-têtes de licence GPL v3 dans les cinquante fichiers de code (Kotlin, Python, HTML), rédigés
en français comme le reste du projet, le texte faisant foi restant celui de `LICENSE`.
## [2.0.1] — 2026-09-13
### Ajouté
- **Licence GNU GPL v3.** Le texte intégral est dans `LICENSE` — copié de la référence système,
empreinte `1ebbd3e34237af26da5dc08a4e440464`, et non retranscrit. Le README expose la formule
complète, y compris le point le plus souvent passé sous silence : toute version modifiée
redistribuée doit l'être sous la même licence, code source compris.
- L'onglet Auteur de la page « À propos » porte la licence et le copyright.
### Corrigé
- La pastille de licence de la page « À propos » ne s'affiche plus en rouge : elle signalait
qu'aucune licence n'était déclarée, ce qui n'est plus le cas.
## [2.0.0] — 2026-09-13
Noxely se sépare en deux : un **serveur** qui collecte, un **mobile** qui écoute. Tout ce qui
tenait le téléphone éveillé a migré ailleurs — c'est la raison d'être de cette version.
### Ajouté
- **Serveur** (`server/`, Python + FastAPI + SQLite). Il porte désormais la recherche dans les
catalogues, le guet des morceaux sur les radios, l'enregistrement des directs et la file de
téléchargement. Une interface web permet de le piloter depuis un navigateur : recherche, guets,
file et bibliothèque.
- **Recherche simultanée sur toutes les sources.** Les quatre catalogues sont interrogés en
parallèle et les résultats fusionnés, chacun étiqueté de son origine, les plus légers en tête.
Un catalogue en panne n'empêche pas les autres de répondre.
- **Balayage radio continu.** Un tour enchaîne sur le suivant au lieu d'attendre trois minutes :
un morceau guetté a été capté en moins de vingt-cinq secondes à la mesure. Une sonde ne lit que
le premier bloc de métadonnées puis referme, ce qui rend la permanence tenable là où garder
quarante flux ouverts coûterait plusieurs mégabits par seconde.
- **Synchronisation client/serveur.** Le mobile demande ce qui a changé depuis son curseur,
télécharge les fichiers prêts et se rendort. Toutes les six heures, en Wi-Fi non facturé et
batterie suffisante.
- **Réglages en sous-onglets** sur le mobile : Connexion, Synchronisation, Application.
- Cibles `make server-*` : environnement, lancement, service systemd, jeton, journal.
### Changé
- **L'application Android devient un client de synchronisation.** Recherche, catalogues, radio,
guets et enregistrement quittent le téléphone : vingt fichiers supprimés. Restent la
bibliothèque, la lecture, les playlists, le hors-ligne et les réglages.
- L'onglet Sources devient Réglages.
### Corrigé
- Le jeton du serveur était régénéré à chaque démarrage : il aurait fallu reconfigurer le mobile
après le moindre redémarrage. Il est désormais conservé dans `data/token`, en lecture seule pour
son propriétaire.
- Wikimedia Commons répondait 403 : sa politique refuse les agents génériques. L'agent annonce
maintenant le projet et son dépôt — 28 résultats là où il n'y en avait aucun. L'erreur était
masquée par la fusion des sources, et n'est apparue qu'en interrogeant la source seule.
- `NOXELY_DATA` pointait par défaut sur `/var/lib/noxely`, inaccessible au compte qui lance
`make server-run` : le défaut devient `./data`, et l'unité systemd crée elle-même son dossier
d'état. Un dossier inutilisable donne désormais une phrase, plus une trace Python.
- La lecture des métadonnées ICY n'itérait rien côté serveur : `iter_bytes` au lieu de
`aiter_bytes` sur un client asynchrone. Trente-six stations écoutées, zéro titre lu.
- Une coupure de l'annuaire Radio Browser faisait échouer tout le balayage : une seconde tentative
est faite, et l'erreur renvoyée est lisible.
### Migration
Le mobile seul ne sert plus à rien : il faut installer le serveur (`make server-venv`, puis
`make server-install`), relever son jeton (`make server-token`) et le saisir dans Réglages ▸
Connexion. Consultée depuis la machine du serveur, l'interface web se remplit seule.
## [1.7.0] — 2026-09-13
### Ajouté
+674
View File
@@ -0,0 +1,674 @@
GNU GENERAL PUBLIC LICENSE
Version 3, 29 June 2007
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
The GNU General Public License is a free, copyleft license for
software and other kinds of works.
The licenses for most software and other practical works are designed
to take away your freedom to share and change the works. By contrast,
the GNU General Public License is intended to guarantee your freedom to
share and change all versions of a program--to make sure it remains free
software for all its users. We, the Free Software Foundation, use the
GNU General Public License for most of our software; it applies also to
any other work released this way by its authors. You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
them if you wish), that you receive source code or can get it if you
want it, that you can change the software or use pieces of it in new
free programs, and that you know you can do these things.
To protect your rights, we need to prevent others from denying you
these rights or asking you to surrender the rights. Therefore, you have
certain responsibilities if you distribute copies of the software, or if
you modify it: responsibilities to respect the freedom of others.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must pass on to the recipients the same
freedoms that you received. You must make sure that they, too, receive
or can get the source code. And you must show them these terms so they
know their rights.
Developers that use the GNU GPL protect your rights with two steps:
(1) assert copyright on the software, and (2) offer you this License
giving you legal permission to copy, distribute and/or modify it.
For the developers' and authors' protection, the GPL clearly explains
that there is no warranty for this free software. For both users' and
authors' sake, the GPL requires that modified versions be marked as
changed, so that their problems will not be attributed erroneously to
authors of previous versions.
Some devices are designed to deny users access to install or run
modified versions of the software inside them, although the manufacturer
can do so. This is fundamentally incompatible with the aim of
protecting users' freedom to change the software. The systematic
pattern of such abuse occurs in the area of products for individuals to
use, which is precisely where it is most unacceptable. Therefore, we
have designed this version of the GPL to prohibit the practice for those
products. If such problems arise substantially in other domains, we
stand ready to extend this provision to those domains in future versions
of the GPL, as needed to protect the freedom of users.
Finally, every program is threatened constantly by software patents.
States should not allow patents to restrict development and use of
software on general-purpose computers, but in those that do, we wish to
avoid the special danger that patents applied to a free program could
make it effectively proprietary. To prevent this, the GPL assures that
patents cannot be used to render the program non-free.
The precise terms and conditions for copying, distribution and
modification follow.
TERMS AND CONDITIONS
0. Definitions.
"This License" refers to version 3 of the GNU General Public License.
"Copyright" also means copyright-like laws that apply to other kinds of
works, such as semiconductor masks.
"The Program" refers to any copyrightable work licensed under this
License. Each licensee is addressed as "you". "Licensees" and
"recipients" may be individuals or organizations.
To "modify" a work means to copy from or adapt all or part of the work
in a fashion requiring copyright permission, other than the making of an
exact copy. The resulting work is called a "modified version" of the
earlier work or a work "based on" the earlier work.
A "covered work" means either the unmodified Program or a work based
on the Program.
To "propagate" a work means to do anything with it that, without
permission, would make you directly or secondarily liable for
infringement under applicable copyright law, except executing it on a
computer or modifying a private copy. Propagation includes copying,
distribution (with or without modification), making available to the
public, and in some countries other activities as well.
To "convey" a work means any kind of propagation that enables other
parties to make or receive copies. Mere interaction with a user through
a computer network, with no transfer of a copy, is not conveying.
An interactive user interface displays "Appropriate Legal Notices"
to the extent that it includes a convenient and prominently visible
feature that (1) displays an appropriate copyright notice, and (2)
tells the user that there is no warranty for the work (except to the
extent that warranties are provided), that licensees may convey the
work under this License, and how to view a copy of this License. If
the interface presents a list of user commands or options, such as a
menu, a prominent item in the list meets this criterion.
1. Source Code.
The "source code" for a work means the preferred form of the work
for making modifications to it. "Object code" means any non-source
form of a work.
A "Standard Interface" means an interface that either is an official
standard defined by a recognized standards body, or, in the case of
interfaces specified for a particular programming language, one that
is widely used among developers working in that language.
The "System Libraries" of an executable work include anything, other
than the work as a whole, that (a) is included in the normal form of
packaging a Major Component, but which is not part of that Major
Component, and (b) serves only to enable use of the work with that
Major Component, or to implement a Standard Interface for which an
implementation is available to the public in source code form. A
"Major Component", in this context, means a major essential component
(kernel, window system, and so on) of the specific operating system
(if any) on which the executable work runs, or a compiler used to
produce the work, or an object code interpreter used to run it.
The "Corresponding Source" for a work in object code form means all
the source code needed to generate, install, and (for an executable
work) run the object code and to modify the work, including scripts to
control those activities. However, it does not include the work's
System Libraries, or general-purpose tools or generally available free
programs which are used unmodified in performing those activities but
which are not part of the work. For example, Corresponding Source
includes interface definition files associated with source files for
the work, and the source code for shared libraries and dynamically
linked subprograms that the work is specifically designed to require,
such as by intimate data communication or control flow between those
subprograms and other parts of the work.
The Corresponding Source need not include anything that users
can regenerate automatically from other parts of the Corresponding
Source.
The Corresponding Source for a work in source code form is that
same work.
2. Basic Permissions.
All rights granted under this License are granted for the term of
copyright on the Program, and are irrevocable provided the stated
conditions are met. This License explicitly affirms your unlimited
permission to run the unmodified Program. The output from running a
covered work is covered by this License only if the output, given its
content, constitutes a covered work. This License acknowledges your
rights of fair use or other equivalent, as provided by copyright law.
You may make, run and propagate covered works that you do not
convey, without conditions so long as your license otherwise remains
in force. You may convey covered works to others for the sole purpose
of having them make modifications exclusively for you, or provide you
with facilities for running those works, provided that you comply with
the terms of this License in conveying all material for which you do
not control copyright. Those thus making or running the covered works
for you must do so exclusively on your behalf, under your direction
and control, on terms that prohibit them from making any copies of
your copyrighted material outside their relationship with you.
Conveying under any other circumstances is permitted solely under
the conditions stated below. Sublicensing is not allowed; section 10
makes it unnecessary.
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
No covered work shall be deemed part of an effective technological
measure under any applicable law fulfilling obligations under article
11 of the WIPO copyright treaty adopted on 20 December 1996, or
similar laws prohibiting or restricting circumvention of such
measures.
When you convey a covered work, you waive any legal power to forbid
circumvention of technological measures to the extent such circumvention
is effected by exercising rights under this License with respect to
the covered work, and you disclaim any intention to limit operation or
modification of the work as a means of enforcing, against the work's
users, your or third parties' legal rights to forbid circumvention of
technological measures.
4. Conveying Verbatim Copies.
You may convey verbatim copies of the Program's source code as you
receive it, in any medium, provided that you conspicuously and
appropriately publish on each copy an appropriate copyright notice;
keep intact all notices stating that this License and any
non-permissive terms added in accord with section 7 apply to the code;
keep intact all notices of the absence of any warranty; and give all
recipients a copy of this License along with the Program.
You may charge any price or no price for each copy that you convey,
and you may offer support or warranty protection for a fee.
5. Conveying Modified Source Versions.
You may convey a work based on the Program, or the modifications to
produce it from the Program, in the form of source code under the
terms of section 4, provided that you also meet all of these conditions:
a) The work must carry prominent notices stating that you modified
it, and giving a relevant date.
b) The work must carry prominent notices stating that it is
released under this License and any conditions added under section
7. This requirement modifies the requirement in section 4 to
"keep intact all notices".
c) You must license the entire work, as a whole, under this
License to anyone who comes into possession of a copy. This
License will therefore apply, along with any applicable section 7
additional terms, to the whole of the work, and all its parts,
regardless of how they are packaged. This License gives no
permission to license the work in any other way, but it does not
invalidate such permission if you have separately received it.
d) If the work has interactive user interfaces, each must display
Appropriate Legal Notices; however, if the Program has interactive
interfaces that do not display Appropriate Legal Notices, your
work need not make them do so.
A compilation of a covered work with other separate and independent
works, which are not by their nature extensions of the covered work,
and which are not combined with it such as to form a larger program,
in or on a volume of a storage or distribution medium, is called an
"aggregate" if the compilation and its resulting copyright are not
used to limit the access or legal rights of the compilation's users
beyond what the individual works permit. Inclusion of a covered work
in an aggregate does not cause this License to apply to the other
parts of the aggregate.
6. Conveying Non-Source Forms.
You may convey a covered work in object code form under the terms
of sections 4 and 5, provided that you also convey the
machine-readable Corresponding Source under the terms of this License,
in one of these ways:
a) Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by the
Corresponding Source fixed on a durable physical medium
customarily used for software interchange.
b) Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by a
written offer, valid for at least three years and valid for as
long as you offer spare parts or customer support for that product
model, to give anyone who possesses the object code either (1) a
copy of the Corresponding Source for all the software in the
product that is covered by this License, on a durable physical
medium customarily used for software interchange, for a price no
more than your reasonable cost of physically performing this
conveying of source, or (2) access to copy the
Corresponding Source from a network server at no charge.
c) Convey individual copies of the object code with a copy of the
written offer to provide the Corresponding Source. This
alternative is allowed only occasionally and noncommercially, and
only if you received the object code with such an offer, in accord
with subsection 6b.
d) Convey the object code by offering access from a designated
place (gratis or for a charge), and offer equivalent access to the
Corresponding Source in the same way through the same place at no
further charge. You need not require recipients to copy the
Corresponding Source along with the object code. If the place to
copy the object code is a network server, the Corresponding Source
may be on a different server (operated by you or a third party)
that supports equivalent copying facilities, provided you maintain
clear directions next to the object code saying where to find the
Corresponding Source. Regardless of what server hosts the
Corresponding Source, you remain obligated to ensure that it is
available for as long as needed to satisfy these requirements.
e) Convey the object code using peer-to-peer transmission, provided
you inform other peers where the object code and Corresponding
Source of the work are being offered to the general public at no
charge under subsection 6d.
A separable portion of the object code, whose source code is excluded
from the Corresponding Source as a System Library, need not be
included in conveying the object code work.
A "User Product" is either (1) a "consumer product", which means any
tangible personal property which is normally used for personal, family,
or household purposes, or (2) anything designed or sold for incorporation
into a dwelling. In determining whether a product is a consumer product,
doubtful cases shall be resolved in favor of coverage. For a particular
product received by a particular user, "normally used" refers to a
typical or common use of that class of product, regardless of the status
of the particular user or of the way in which the particular user
actually uses, or expects or is expected to use, the product. A product
is a consumer product regardless of whether the product has substantial
commercial, industrial or non-consumer uses, unless such uses represent
the only significant mode of use of the product.
"Installation Information" for a User Product means any methods,
procedures, authorization keys, or other information required to install
and execute modified versions of a covered work in that User Product from
a modified version of its Corresponding Source. The information must
suffice to ensure that the continued functioning of the modified object
code is in no case prevented or interfered with solely because
modification has been made.
If you convey an object code work under this section in, or with, or
specifically for use in, a User Product, and the conveying occurs as
part of a transaction in which the right of possession and use of the
User Product is transferred to the recipient in perpetuity or for a
fixed term (regardless of how the transaction is characterized), the
Corresponding Source conveyed under this section must be accompanied
by the Installation Information. But this requirement does not apply
if neither you nor any third party retains the ability to install
modified object code on the User Product (for example, the work has
been installed in ROM).
The requirement to provide Installation Information does not include a
requirement to continue to provide support service, warranty, or updates
for a work that has been modified or installed by the recipient, or for
the User Product in which it has been modified or installed. Access to a
network may be denied when the modification itself materially and
adversely affects the operation of the network or violates the rules and
protocols for communication across the network.
Corresponding Source conveyed, and Installation Information provided,
in accord with this section must be in a format that is publicly
documented (and with an implementation available to the public in
source code form), and must require no special password or key for
unpacking, reading or copying.
7. Additional Terms.
"Additional permissions" are terms that supplement the terms of this
License by making exceptions from one or more of its conditions.
Additional permissions that are applicable to the entire Program shall
be treated as though they were included in this License, to the extent
that they are valid under applicable law. If additional permissions
apply only to part of the Program, that part may be used separately
under those permissions, but the entire Program remains governed by
this License without regard to the additional permissions.
When you convey a copy of a covered work, you may at your option
remove any additional permissions from that copy, or from any part of
it. (Additional permissions may be written to require their own
removal in certain cases when you modify the work.) You may place
additional permissions on material, added by you to a covered work,
for which you have or can give appropriate copyright permission.
Notwithstanding any other provision of this License, for material you
add to a covered work, you may (if authorized by the copyright holders of
that material) supplement the terms of this License with terms:
a) Disclaiming warranty or limiting liability differently from the
terms of sections 15 and 16 of this License; or
b) Requiring preservation of specified reasonable legal notices or
author attributions in that material or in the Appropriate Legal
Notices displayed by works containing it; or
c) Prohibiting misrepresentation of the origin of that material, or
requiring that modified versions of such material be marked in
reasonable ways as different from the original version; or
d) Limiting the use for publicity purposes of names of licensors or
authors of the material; or
e) Declining to grant rights under trademark law for use of some
trade names, trademarks, or service marks; or
f) Requiring indemnification of licensors and authors of that
material by anyone who conveys the material (or modified versions of
it) with contractual assumptions of liability to the recipient, for
any liability that these contractual assumptions directly impose on
those licensors and authors.
All other non-permissive additional terms are considered "further
restrictions" within the meaning of section 10. If the Program as you
received it, or any part of it, contains a notice stating that it is
governed by this License along with a term that is a further
restriction, you may remove that term. If a license document contains
a further restriction but permits relicensing or conveying under this
License, you may add to a covered work material governed by the terms
of that license document, provided that the further restriction does
not survive such relicensing or conveying.
If you add terms to a covered work in accord with this section, you
must place, in the relevant source files, a statement of the
additional terms that apply to those files, or a notice indicating
where to find the applicable terms.
Additional terms, permissive or non-permissive, may be stated in the
form of a separately written license, or stated as exceptions;
the above requirements apply either way.
8. Termination.
You may not propagate or modify a covered work except as expressly
provided under this License. Any attempt otherwise to propagate or
modify it is void, and will automatically terminate your rights under
this License (including any patent licenses granted under the third
paragraph of section 11).
However, if you cease all violation of this License, then your
license from a particular copyright holder is reinstated (a)
provisionally, unless and until the copyright holder explicitly and
finally terminates your license, and (b) permanently, if the copyright
holder fails to notify you of the violation by some reasonable means
prior to 60 days after the cessation.
Moreover, your license from a particular copyright holder is
reinstated permanently if the copyright holder notifies you of the
violation by some reasonable means, this is the first time you have
received notice of violation of this License (for any work) from that
copyright holder, and you cure the violation prior to 30 days after
your receipt of the notice.
Termination of your rights under this section does not terminate the
licenses of parties who have received copies or rights from you under
this License. If your rights have been terminated and not permanently
reinstated, you do not qualify to receive new licenses for the same
material under section 10.
9. Acceptance Not Required for Having Copies.
You are not required to accept this License in order to receive or
run a copy of the Program. Ancillary propagation of a covered work
occurring solely as a consequence of using peer-to-peer transmission
to receive a copy likewise does not require acceptance. However,
nothing other than this License grants you permission to propagate or
modify any covered work. These actions infringe copyright if you do
not accept this License. Therefore, by modifying or propagating a
covered work, you indicate your acceptance of this License to do so.
10. Automatic Licensing of Downstream Recipients.
Each time you convey a covered work, the recipient automatically
receives a license from the original licensors, to run, modify and
propagate that work, subject to this License. You are not responsible
for enforcing compliance by third parties with this License.
An "entity transaction" is a transaction transferring control of an
organization, or substantially all assets of one, or subdividing an
organization, or merging organizations. If propagation of a covered
work results from an entity transaction, each party to that
transaction who receives a copy of the work also receives whatever
licenses to the work the party's predecessor in interest had or could
give under the previous paragraph, plus a right to possession of the
Corresponding Source of the work from the predecessor in interest, if
the predecessor has it or can get it with reasonable efforts.
You may not impose any further restrictions on the exercise of the
rights granted or affirmed under this License. For example, you may
not impose a license fee, royalty, or other charge for exercise of
rights granted under this License, and you may not initiate litigation
(including a cross-claim or counterclaim in a lawsuit) alleging that
any patent claim is infringed by making, using, selling, offering for
sale, or importing the Program or any portion of it.
11. Patents.
A "contributor" is a copyright holder who authorizes use under this
License of the Program or a work on which the Program is based. The
work thus licensed is called the contributor's "contributor version".
A contributor's "essential patent claims" are all patent claims
owned or controlled by the contributor, whether already acquired or
hereafter acquired, that would be infringed by some manner, permitted
by this License, of making, using, or selling its contributor version,
but do not include claims that would be infringed only as a
consequence of further modification of the contributor version. For
purposes of this definition, "control" includes the right to grant
patent sublicenses in a manner consistent with the requirements of
this License.
Each contributor grants you a non-exclusive, worldwide, royalty-free
patent license under the contributor's essential patent claims, to
make, use, sell, offer for sale, import and otherwise run, modify and
propagate the contents of its contributor version.
In the following three paragraphs, a "patent license" is any express
agreement or commitment, however denominated, not to enforce a patent
(such as an express permission to practice a patent or covenant not to
sue for patent infringement). To "grant" such a patent license to a
party means to make such an agreement or commitment not to enforce a
patent against the party.
If you convey a covered work, knowingly relying on a patent license,
and the Corresponding Source of the work is not available for anyone
to copy, free of charge and under the terms of this License, through a
publicly available network server or other readily accessible means,
then you must either (1) cause the Corresponding Source to be so
available, or (2) arrange to deprive yourself of the benefit of the
patent license for this particular work, or (3) arrange, in a manner
consistent with the requirements of this License, to extend the patent
license to downstream recipients. "Knowingly relying" means you have
actual knowledge that, but for the patent license, your conveying the
covered work in a country, or your recipient's use of the covered work
in a country, would infringe one or more identifiable patents in that
country that you have reason to believe are valid.
If, pursuant to or in connection with a single transaction or
arrangement, you convey, or propagate by procuring conveyance of, a
covered work, and grant a patent license to some of the parties
receiving the covered work authorizing them to use, propagate, modify
or convey a specific copy of the covered work, then the patent license
you grant is automatically extended to all recipients of the covered
work and works based on it.
A patent license is "discriminatory" if it does not include within
the scope of its coverage, prohibits the exercise of, or is
conditioned on the non-exercise of one or more of the rights that are
specifically granted under this License. You may not convey a covered
work if you are a party to an arrangement with a third party that is
in the business of distributing software, under which you make payment
to the third party based on the extent of your activity of conveying
the work, and under which the third party grants, to any of the
parties who would receive the covered work from you, a discriminatory
patent license (a) in connection with copies of the covered work
conveyed by you (or copies made from those copies), or (b) primarily
for and in connection with specific products or compilations that
contain the covered work, unless you entered into that arrangement,
or that patent license was granted, prior to 28 March 2007.
Nothing in this License shall be construed as excluding or limiting
any implied license or other defenses to infringement that may
otherwise be available to you under applicable patent law.
12. No Surrender of Others' Freedom.
If conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot convey a
covered work so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you may
not convey it at all. For example, if you agree to terms that obligate you
to collect a royalty for further conveying from those to whom you convey
the Program, the only way you could satisfy both those terms and this
License would be to refrain entirely from conveying the Program.
13. Use with the GNU Affero General Public License.
Notwithstanding any other provision of this License, you have
permission to link or combine any covered work with a work licensed
under version 3 of the GNU Affero General Public License into a single
combined work, and to convey the resulting work. The terms of this
License will continue to apply to the part which is the covered work,
but the special requirements of the GNU Affero General Public License,
section 13, concerning interaction through a network will apply to the
combination as such.
14. Revised Versions of this License.
The Free Software Foundation may publish revised and/or new versions of
the GNU General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.
Each version is given a distinguishing version number. If the
Program specifies that a certain numbered version of the GNU General
Public License "or any later version" applies to it, you have the
option of following the terms and conditions either of that numbered
version or of any later version published by the Free Software
Foundation. If the Program does not specify a version number of the
GNU General Public License, you may choose any version ever published
by the Free Software Foundation.
If the Program specifies that a proxy can decide which future
versions of the GNU General Public License can be used, that proxy's
public statement of acceptance of a version permanently authorizes you
to choose that version for the Program.
Later license versions may give you additional or different
permissions. However, no additional obligations are imposed on any
author or copyright holder as a result of your choosing to follow a
later version.
15. Disclaimer of Warranty.
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
16. Limitation of Liability.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.
17. Interpretation of Sections 15 and 16.
If the disclaimer of warranty and limitation of liability provided
above cannot be given local legal effect according to their terms,
reviewing courts shall apply local law that most closely approximates
an absolute waiver of all civil liability in connection with the
Program, unless a warranty or assumption of liability accompanies a
copy of the Program in return for a fee.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these terms.
To do so, attach the following notices to the program. It is safest
to attach them to the start of each source file to most effectively
state the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.
<one line to give the program's name and a brief idea of what it does.>
Copyright (C) <year> <name of author>
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
Also add information on how to contact you by electronic and paper mail.
If the program does terminal interaction, make it output a short
notice like this when it starts in an interactive mode:
<program> Copyright (C) <year> <name of author>
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License. Of course, your program's commands
might be different; for a GUI interface, you would use an "about box".
You should also get your employer (if you work as a programmer) or school,
if any, to sign a "copyright disclaimer" for the program, if necessary.
For more information on this, and how to apply and follow the GNU GPL, see
<https://www.gnu.org/licenses/>.
The GNU General Public License does not permit incorporating your program
into proprietary programs. If your program is a subroutine library, you
may consider it more useful to permit linking proprietary applications with
the library. If this is what you want to do, use the GNU Lesser General
Public License instead of this License. But first, please read
<https://www.gnu.org/licenses/why-not-lgpl.html>.
+58
View File
@@ -86,6 +86,64 @@ logcat: ## Suit les journaux de l'application (Ctrl+C pour arrêter)
crash: ## Affiche la dernière trace de plantage éventuelle
@$(ADB) logcat -d -v brief | grep -A 30 -E "FATAL EXCEPTION" | tail -40 || echo "Aucun plantage enregistré"
##@ 🖥️ Serveur
SERVER := server
SERVER_PY := $(SERVER)/venv/bin/python
SERVICE := noxely-server
UNIT_FILE := $(SERVER)/deploy/$(SERVICE).service
UNIT_DEST := /etc/systemd/system/$(SERVICE).service
PROJECT_DIR := $(abspath .)
SERVICE_USER ?= $(shell whoami)
.PHONY: server-venv
server-venv: ## Crée l'environnement Python du serveur et installe ses dépendances
python3 -m venv $(SERVER)/venv
$(SERVER)/venv/bin/pip install -q -r $(SERVER)/requirements.txt
@echo "→ $(SERVER_PY)"
.PHONY: server-token
server-token: ## Affiche le jeton du serveur (à recopier dans l'application)
@sed -n 's/^NOXELY_TOKEN=//p' $(SERVER)/.env 2>/dev/null | grep . \
|| cat $(SERVER)/data/token 2>/dev/null \
|| echo "Aucun jeton : lancez le serveur une fois, il en génère un."
.PHONY: server-run
server-run: ## Lance le serveur au premier plan (Ctrl+C pour arrêter)
@test -f $(SERVER)/.env || { echo "❌ $(SERVER)/.env absent — copiez $(SERVER)/.env.example"; exit 1; }
cd $(SERVER) && set -a && . ./.env && set +a && ./venv/bin/python -m noxely_server
.PHONY: server-install
server-install: ## Installe et active le service systemd (sudo requis)
@test -f $(SERVER)/.env || { echo "❌ $(SERVER)/.env absent — copiez $(SERVER)/.env.example"; exit 1; }
sed -e 's|__SERVICE_USER__|$(SERVICE_USER)|g' -e 's|@USER@|$(SERVICE_USER)|g' \
-e 's|@PROJECT@|$(PROJECT_DIR)|g' $(UNIT_FILE) | sudo tee $(UNIT_DEST) > /dev/null
sudo systemctl daemon-reload
sudo systemctl enable --now $(SERVICE)
@echo "✅ $(SERVICE) installé et démarré"
.PHONY: server-start
server-start: ## Démarre le service
sudo systemctl start $(SERVICE)
.PHONY: server-stop
server-stop: ## Arrête le service
sudo systemctl stop $(SERVICE)
.PHONY: server-status
server-status: ## État du service
systemctl status $(SERVICE) --no-pager
.PHONY: server-logs
server-logs: ## Suit le journal du service
journalctl -u $(SERVICE) -f
.PHONY: server-uninstall
server-uninstall: ## Désactive et retire le service (les données sont conservées)
sudo systemctl disable --now $(SERVICE) || true
sudo rm -f $(UNIT_DEST)
sudo systemctl daemon-reload
##@ 📤 Publication
.PHONY: publish
+58 -29
View File
@@ -1,12 +1,14 @@
# 🎧 Noxely
> Mettez la musique et les vidéos **de côté** pendant que vous avez du réseau. Écoutez-les quand vous n'en avez plus.
> Un serveur cherche, guette les radios et enregistre. Le téléphone ne fait que récupérer les
> fichiers prêts — et garde sa batterie.
[![Platform](https://img.shields.io/badge/Plateforme-Android%208.0%2B-3DDC84?logo=android&logoColor=white)](https://developer.android.com)
[![Kotlin](https://img.shields.io/badge/Kotlin-2.1.0-7F52FF?logo=kotlin&logoColor=white)](https://kotlinlang.org)
[![Compose](https://img.shields.io/badge/Jetpack%20Compose-Material%203-4285F4?logo=jetpackcompose&logoColor=white)](https://developer.android.com/jetpack/compose)
[![Media3](https://img.shields.io/badge/Media3-1.11.1-FF6F00?logo=googleplay&logoColor=white)](https://developer.android.com/media/media3)
[![Version](https://img.shields.io/badge/Version-1.7.0-6B4EFF)](VERSION)
[![Version](https://img.shields.io/badge/Version-2.2.0-6B4EFF)](VERSION)
[![Licence](https://img.shields.io/badge/Licence-GPL%20v3-3FD8C0)](LICENSE)
[![Hors ligne](https://img.shields.io/badge/Hors%20ligne-100%25-3FD8C0)](#-comment-ça-marche)
Noxely est un lecteur audio et vidéo pensé pour les trajets, les tunnels, les avions et les
@@ -23,41 +25,55 @@ sans la moindre connexion.
---
## ✨ Fonctionnalités
## 🏗️ Architecture
```
SERVEUR (Python / FastAPI, sur votre machine)
├── cherche dans les catalogues libres
├── guette les morceaux sur les radios
├── enregistre les directs, titrage ICY compris
└── tient les fichiers prêts
│ HTTP + jeton
▼
MOBILE (Android / Compose)
└── demande ce qui est neuf, télécharge, lit
Wi-Fi non facturé · batterie suffisante · toutes les 6 h
```
Tout ce qui écoutait en continu a migré sur le serveur. Le téléphone dort entre deux
synchronisations : c'est là qu'est l'économie.
## ✨ Ce que fait le serveur
| | |
|---|---|
| 🎵 **Audio et vidéo** | Un seul lecteur, une seule file d'attente, la vidéo bascule sur une surface dédiée |
| 📥 **Mise en cache explicite** | Rien n'est téléchargé sans un geste : vous décidez quoi garder |
| 🔍 **Parcours des sources** | On entre dans une source, on coche ce qu'on veut, on télécharge en lot |
| 🎧 **Écoute avant téléchargement** | Chaque piste s'essaie en ligne d'un appui, sans rien mettre en cache |
| 🧾 **Choix piste par piste** | Un album ou un livre affiche ses pistes avec leur taille : on n'emporte que ce qu'on veut |
| 🌍 **Filtrage par langue** | Français, anglais, allemand, espagnol, italien, néerlandais |
| 📋 **Playlists** | Listes nommées, appui long pour y ajouter un titre, lecture enchaînée |
| 🎼 **Catalogues libres de droits** | Recherche intégrée dans Internet Archive et LibriVox, sans compte ni clé d'API |
| 📻 **Podcasts RSS** | Un flux, ses épisodes, et le choix de ceux qu'on emporte |
| 🔗 **Liens directs** | N'importe quelle URL audio ou vidéo, y compris un serveur média auto-hébergé |
| 📱 **Contenu de l'appareil** | Lecture de la bibliothèque MediaStore, déjà disponible hors connexion par nature |
| 🎛️ **Lecture en arrière-plan** | Notification système, casque, Bluetooth, écran verrouillé |
| ⏯️ **Contrôles complets** | Lecture, pause, arrêt, piste précédente et suivante, ±15 s |
| 🌙 **Thème clair et sombre** | Material 3, palette de marque, contraste garanti |
| 🔁 **Reprise automatique** | Réseau coupé : mise en attente et reprise. Échec serveur : relance seule après 5 s, 15 s, 45 s |
| 📻 **Radio** | Les stations les plus écoutées, en direct — et enregistrables d'un appui |
| 🏷️ **Titrage automatique** | L'enregistrement prend le nom du morceau annoncé par la station |
| ℹ️ **Page « À propos »** | Fonctions, garanties, pile technique, journal et auteur |
| 👀 **Titre en cours** | Ce que diffuse chaque station, lu dans son flux |
| ⏰ **Guet d'un titre** | L'enregistrement se déclenche quand le morceau voulu passe, et s'arrête à sa fin |
| 📡 **Guet sur toutes les stations** | Nommez un morceau : Noxely balaie l'annuaire jusqu'à le trouver |
| 🖼️ **Pochettes automatiques** | Les titres sans image en reçoivent une, cherchée sur leur nom |
| 🆕 **Mise à jour intégrée** | Surveille les releases du dépôt, télécharge l'APK en Wi-Fi et propose l'installation |
| 🔎 **Recherche** | Internet Archive, Underground (netlabels + Free Music Archive), LibriVox, Wikimedia Commons |
| 🧾 **Choix piste par piste** | Un album affiche ses pistes avec leur taille avant d'être mis en file |
| 📡 **Guet multi-stations** | Nommez un morceau : les stations les plus écoutées sont balayées jusqu'à le trouver |
| 📻 **Enregistrement** | Capture du direct, nommée d'après le titre annoncé par la station |
| ⏳ **File de téléchargement** | Reprise après échec, état visible |
| 🖥️ **Interface web** | Tout se pilote depuis un navigateur, sans toucher au téléphone |
## 📱 Ce que fait le mobile
| | |
|---|---|
| 🔄 **Synchronisation sobre** | Toutes les 6 h, en Wi-Fi non facturé et batterie suffisante |
| 📱 **Appairage** | Un bouton côté serveur, un bouton côté téléphone : aucun jeton à recopier |
| 🔑 **Un jeton par appareil** | Chacun le sien, révocable seul depuis l'onglet Appareils |
| 🎵 **Lecture** | Audio et vidéo, arrière-plan, casque, écran verrouillé, ±15 s, stop |
| 📚 **Bibliothèque** | Médias reçus du serveur et contenu déjà présent sur l'appareil |
| 📋 **Playlists** | Listes nommées, appui long pour y ajouter un titre |
| 🖼️ **Pochettes** | Cherchées automatiquement pour les titres qui n'en ont pas |
| ℹ️ **À propos et mises à jour** | Version, garanties, journal, et suivi des releases du dépôt |
---
## 📦 Sources disponibles
## 📦 Sources interrogées par le serveur
| Source | État | Détail |
|---|:---:|---|
| 📱 Appareil | ✅ | Musique et vidéos MediaStore |
| 📱 Appareil | ✅ | Musique et vidéos déjà sur le téléphone (côté mobile) |
| 🔗 Lien direct | ✅ | URL `http(s)` vers un fichier audio ou vidéo |
| 📻 Podcast RSS | ✅ | Flux standard avec `<enclosure>` |
| 🏛️ Internet Archive | ✅ | Domaine public / Creative Commons |
@@ -286,4 +302,17 @@ Validé sur émulateur Pixel (Android 17, API 37) :
## 📄 Licence
À définir par l'auteur du dépôt.
**GNU General Public License v3.0** — le texte intégral est dans [LICENSE](LICENSE).
Copyright © 2026 Johnny (tuxgyver)
Noxely est un logiciel libre : vous pouvez le redistribuer et le modifier selon les termes de la
GPL v3, telle que publiée par la Free Software Foundation, au choix dans sa version 3 ou dans une
version ultérieure.
Il est distribué dans l'espoir d'être utile, mais **sans aucune garantie**, sans même la garantie
implicite de qualité marchande ou d'adéquation à un usage particulier. Voir la licence pour le
détail.
Ce choix engage aussi celui qui redistribue : toute version modifiée diffusée doit l'être sous la
même licence, code source compris.
+1 -1
View File
@@ -1 +1 @@
1.7.0
2.3.0
-10
View File
@@ -59,16 +59,6 @@
</intent-filter>
</service>
<service
android:name=".radio.RecordingService"
android:exported="false"
android:foregroundServiceType="dataSync" />
<service
android:name=".radio.WatchService"
android:exported="false"
android:foregroundServiceType="dataSync" />
<provider
android:name="androidx.core.content.FileProvider"
android:authorities="${applicationId}.fileprovider"
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely
import android.Manifest
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely
import android.app.Application
@@ -10,17 +22,9 @@ import fr.tuxgyver.noxely.library.PlaylistStore
import fr.tuxgyver.noxely.offline.DownloadTracker
import fr.tuxgyver.noxely.offline.OfflineModule
import fr.tuxgyver.noxely.playback.PlayerController
import fr.tuxgyver.noxely.radio.RadioDirectory
import fr.tuxgyver.noxely.radio.WatchScanner
import fr.tuxgyver.noxely.radio.WatchStore
import fr.tuxgyver.noxely.sources.ArchiveOrgCatalog
import fr.tuxgyver.noxely.sources.Catalog
import fr.tuxgyver.noxely.sources.CatalogId
import fr.tuxgyver.noxely.sources.CatalogItem
import fr.tuxgyver.noxely.sources.WikimediaCatalog
import fr.tuxgyver.noxely.sources.LibriVoxCatalog
import fr.tuxgyver.noxely.sources.RssImporter
import fr.tuxgyver.noxely.sources.UrlImporter
import fr.tuxgyver.noxely.sync.ServerSettings
import fr.tuxgyver.noxely.sync.SyncClient
import fr.tuxgyver.noxely.sync.SyncWorker
import fr.tuxgyver.noxely.update.UpdateCheckWorker
import fr.tuxgyver.noxely.update.UpdateRepository
import kotlinx.coroutines.CoroutineScope
@@ -45,28 +49,12 @@ class AppContainer(context: Context) {
val playlists = PlaylistStore(context, scope)
val artwork = ArtworkFinder()
val radio = RadioDirectory()
val watches = WatchStore(context, scope)
val watchScanner = WatchScanner(radio, watches)
val serverSettings = ServerSettings(context, scope)
val sync = SyncClient(context, serverSettings, imported)
val urlImporter = UrlImporter()
val rssImporter = RssImporter()
val catalogs: Map<CatalogId, Catalog> = listOf(
ArchiveOrgCatalog(),
ArchiveOrgCatalog(
id = CatalogId.UNDERGROUND,
collections = listOf("netlabels", "freemusicarchive"),
),
LibriVoxCatalog(rssImporter),
WikimediaCatalog(),
).associateBy { it.id }
/**
* Résultat de catalogue en cours de consultation.
* Un identifiant de route ne suffirait pas à le reconstituer sans un appel réseau de plus.
*/
var openedCatalogItem: CatalogItem? = null
val player = PlayerController(context, scope) { id -> library.entry(id) }
@@ -82,6 +70,6 @@ class NoxelyApp : Application() {
super.onCreate()
container = AppContainer(this)
UpdateCheckWorker.schedule(this)
WatchScanner.schedule(this)
SyncWorker.schedule(this)
}
}
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.library
import fr.tuxgyver.noxely.model.MediaEntry
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.library
import android.content.Context
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.library
import fr.tuxgyver.noxely.model.MediaEntry
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.library
import android.content.ContentUris
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.library
import android.content.Context
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.model
import kotlinx.serialization.Serializable
@@ -10,6 +22,7 @@ enum class SourceKind(val label: String) {
URL("Lien direct"),
PODCAST("Podcast"),
RECORDING("Enregistrement"),
SERVER("Serveur"),
}
/**
@@ -33,5 +46,5 @@ data class MediaEntry(
val sizeBytes: Long? = null,
) {
/** Local ou enregistré : le fichier est déjà sur l'appareil, il n'y a rien à télécharger. */
val isRemote: Boolean get() = source != SourceKind.LOCAL && source != SourceKind.RECORDING
val isRemote: Boolean get() = source == SourceKind.URL || source == SourceKind.PODCAST
}
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.model
import kotlinx.serialization.Serializable
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.offline
import android.content.Context
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.offline
import android.app.Notification
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.offline
import android.content.Context
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.playback
import androidx.core.net.toUri
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.playback
import android.app.PendingIntent
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.playback
import android.content.ComponentName
@@ -1,127 +0,0 @@
package fr.tuxgyver.noxely.radio
import fr.tuxgyver.noxely.sources.openConnection
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
import kotlinx.serialization.json.Json
import kotlinx.serialization.json.JsonArray
import kotlinx.serialization.json.JsonObject
import kotlinx.serialization.json.JsonPrimitive
import java.net.URLEncoder
/**
* Annuaire des stations, via l'API communautaire Radio Browser (sans clé).
*
* Les flux HLS sont écartés : ils se lisent, mais ne s'enregistrent pas en copiant les octets,
* et proposer un bouton qui échouerait vaudrait moins que ne pas le proposer.
*/
class RadioDirectory {
private val json = Json { ignoreUnknownKeys = true }
/** Les stations les plus écoutées, éventuellement restreintes à un genre. */
suspend fun popular(genre: String? = null): Result<List<RadioStation>> =
query(buildString {
append("?limit=60&hidebroken=true&order=clickcount&reverse=true")
genre?.let { append("&tag=${URLEncoder.encode(it, "UTF-8")}") }
})
suspend fun search(name: String): Result<List<RadioStation>> =
query("?limit=60&hidebroken=true&order=clickcount&reverse=true" +
"&name=${URLEncoder.encode(name.trim(), "UTF-8")}")
/**
* Le morceau diffusé à l'instant par une station.
*
* Aucun annuaire ne l'expose : il faut ouvrir le flux, lire le premier bloc de métadonnées
* ICY, puis refermer. C'est une connexion par station — d'où l'appel par petits paquets et
* la mise en cache par l'appelant plutôt qu'un balayage systématique.
*/
suspend fun nowPlaying(streamUrl: String): String? = withContext(Dispatchers.IO) {
runCatching {
val connection = openConnection(streamUrl, readTimeoutMs = 8_000).apply {
setRequestProperty("Icy-MetaData", "1")
}
try {
if (connection.responseCode !in 200..299) return@runCatching null
val interval = connection.getHeaderFieldInt("icy-metaint", 0)
if (interval <= 0) return@runCatching null
connection.inputStream.use { input ->
val skip = ByteArray(interval)
var filled = 0
while (filled < interval) {
val read = input.read(skip, filled, interval - filled)
if (read < 0) return@runCatching null
filled += read
}
val length = input.read().takeIf { it >= 0 }?.times(16) ?: return@runCatching null
if (length == 0) return@runCatching null
val meta = ByteArray(length)
filled = 0
while (filled < length) {
val read = input.read(meta, filled, length - filled)
if (read < 0) return@runCatching null
filled += read
}
STREAM_TITLE.find(String(meta, Charsets.UTF_8))
?.groupValues?.get(1)?.trim()?.takeIf { it.isNotBlank() }
}
} finally {
connection.disconnect()
}
}.getOrNull()
}
private suspend fun query(suffix: String): Result<List<RadioStation>> = withContext(Dispatchers.IO) {
runCatching {
val connection = openConnection("$BASE$suffix", readTimeoutMs = 30_000)
val body = try {
if (connection.responseCode !in 200..299) {
throw IllegalStateException("L'annuaire a répondu ${connection.responseCode}")
}
connection.inputStream.bufferedReader().readText()
} finally {
connection.disconnect()
}
(json.parseToJsonElement(body) as? JsonArray).orEmpty()
.mapNotNull { it as? JsonObject }
.filter { it.number("hls") == 0L }
.mapNotNull { station ->
val url = station.string("url_resolved")?.takeIf { it.startsWith("http") }
?: return@mapNotNull null
RadioStation(
id = station.string("stationuuid") ?: url,
name = station.string("name")?.trim() ?: "Station",
streamUrl = url,
codec = station.string("codec").orEmpty(),
bitrate = station.number("bitrate")?.toInt() ?: 0,
country = station.string("country").orEmpty(),
tags = station.string("tags").orEmpty(),
faviconUrl = station.string("favicon")?.takeIf { it.startsWith("http") },
)
}
.distinctBy { it.streamUrl }
}
}
private companion object {
const val BASE = "https://de1.api.radio-browser.info/json/stations/search"
/** Le titre court jusqu'à la fin du champ ICY : les apostrophes y sont fréquentes. */
val STREAM_TITLE = Regex("StreamTitle='(.*?)';")
/** Genres proposés d'emblée, parmi les plus fournis de l'annuaire. */
fun JsonArray?.orEmpty(): JsonArray = this ?: JsonArray(emptyList())
fun JsonObject.string(key: String): String? =
(this[key] as? JsonPrimitive)?.content?.takeIf { it.isNotBlank() && it != "null" }
fun JsonObject.number(key: String): Long? =
(this[key] as? JsonPrimitive)?.content?.substringBefore('.')?.toLongOrNull()
}
}
/** Genres offerts en filtre rapide. */
val RADIO_GENRES = listOf("pop", "rock", "jazz", "classical", "electronic", "news", "chanson")
@@ -1,20 +0,0 @@
package fr.tuxgyver.noxely.radio
/** Une station de radio et son flux direct. */
data class RadioStation(
val id: String,
val name: String,
val streamUrl: String,
val codec: String,
val bitrate: Int,
val country: String,
val tags: String,
val faviconUrl: String?,
) {
val subtitle: String
get() = listOfNotNull(
country.takeIf { it.isNotBlank() },
tags.split(',').firstOrNull()?.trim()?.takeIf { it.isNotBlank() }?.replaceFirstChar(Char::uppercase),
bitrate.takeIf { it > 0 }?.let { "$it kbps" },
).joinToString(" · ")
}
@@ -1,54 +0,0 @@
package fr.tuxgyver.noxely.radio
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.StateFlow
import kotlinx.coroutines.flow.asStateFlow
data class RecordingStatus(
val station: RadioStation? = null,
val startedAt: Long = 0L,
val bytes: Long = 0L,
/** Titre annoncé par le flux, quand la station en diffuse un. */
val currentTitle: String? = null,
/** Titre attendu avant de commencer à écrire, si l'enregistrement a été programmé. */
val waitingFor: String? = null,
) {
val isRecording: Boolean get() = station != null
val elapsedMs: Long get() = if (startedAt == 0L) 0L else System.currentTimeMillis() - startedAt
}
/**
* État de l'enregistrement en cours.
*
* Seul [RecordingService] y écrit ; l'interface ne fait que l'observer. Un singleton se justifie
* ici parce que l'enregistrement est unique par nature : on n'enregistre qu'une station à la fois.
*/
object Recorder {
private val _status = MutableStateFlow(RecordingStatus())
val status: StateFlow<RecordingStatus> = _status.asStateFlow()
internal fun started(station: RadioStation, waitingFor: String? = null) {
_status.value = RecordingStatus(station, System.currentTimeMillis(), 0L, waitingFor = waitingFor)
}
/** Le morceau attendu commence : l'écriture démarre maintenant. */
internal fun armed(title: String) {
_status.value = _status.value.copy(
waitingFor = null,
currentTitle = title,
startedAt = System.currentTimeMillis(),
)
}
internal fun progress(bytes: Long) {
_status.value = _status.value.copy(bytes = bytes)
}
internal fun title(title: String) {
_status.value = _status.value.copy(currentTitle = title)
}
internal fun stopped() {
_status.value = RecordingStatus()
}
}
@@ -1,380 +0,0 @@
package fr.tuxgyver.noxely.radio
import android.app.Notification
import android.app.NotificationChannel
import android.app.NotificationManager
import android.app.PendingIntent
import android.app.Service
import android.content.Context
import android.content.Intent
import android.content.pm.ServiceInfo
import android.os.Build
import android.os.IBinder
import androidx.core.app.NotificationCompat
import fr.tuxgyver.noxely.NoxelyApp
import fr.tuxgyver.noxely.MainActivity
import fr.tuxgyver.noxely.R
import fr.tuxgyver.noxely.model.MediaEntry
import fr.tuxgyver.noxely.model.MediaKind
import fr.tuxgyver.noxely.model.SourceKind
import fr.tuxgyver.noxely.sources.openConnection
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.Job
import kotlinx.coroutines.SupervisorJob
import kotlinx.coroutines.cancel
import kotlinx.coroutines.currentCoroutineContext
import kotlinx.coroutines.isActive
import kotlinx.coroutines.launch
import java.io.File
import java.io.FileOutputStream
import java.text.SimpleDateFormat
import java.util.Date
import java.util.Locale
/**
* Enregistre un flux radio en copiant ses octets dans un fichier.
*
* Un direct n'a pas de fin : `DownloadManager`, qui attend une taille et une complétion, ne peut
* pas s'en charger. L'enregistrement tourne donc en service de premier plan jusqu'à ce que
* l'utilisateur l'arrête, et le fichier obtenu rejoint la bibliothèque comme média local.
*/
class RecordingService : Service() {
private val scope = CoroutineScope(SupervisorJob() + Dispatchers.IO)
private var job: Job? = null
private var sink: RecordingSink? = null
private var sinkTitle: String = ""
private var station: RadioStation? = null
private var firstTitle: String? = null
private var trigger: String? = null
override fun onBind(intent: Intent?): IBinder? = null
override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
when (intent?.action) {
ACTION_STOP -> {
finish()
return START_NOT_STICKY
}
ACTION_START -> {
val incoming = intent.toStation() ?: run {
stopSelf()
return START_NOT_STICKY
}
if (job?.isActive == true) return START_STICKY
trigger = intent.getStringExtra(EXTRA_TRIGGER)?.takeIf { it.isNotBlank() }
begin(incoming)
}
}
return START_STICKY
}
private fun begin(incoming: RadioStation) {
station = incoming
firstTitle = null
Recorder.started(incoming, trigger)
startForegroundCompat(notification(incoming, 0L))
val stamp = SimpleDateFormat("yyyy-MM-dd-HHmm", Locale.FRANCE).format(Date())
val extension = incoming.extension()
sinkTitle = "${incoming.name} — ${SimpleDateFormat("d MMM HH:mm", Locale.FRANCE).format(Date())}"
val output = RecordingSink(
context = this,
fileName = "${incoming.name.sanitized()}-$stamp.$extension",
mimeType = if (extension == "aac") "audio/aac" else "audio/mpeg",
)
sink = output
job = scope.launch {
runCatching {
// « Icy-MetaData: 1 » demande à la station d'intercaler le titre en cours dans le
// flux. Ces octets ne sont pas de l'audio : ils doivent être retirés avant écriture,
// sinon le fichier obtenu est corrompu.
val connection = openConnection(incoming.streamUrl, readTimeoutMs = 30_000).apply {
setRequestProperty("Icy-MetaData", "1")
}
try {
if (connection.responseCode !in 200..299) {
throw IllegalStateException("Flux indisponible (${connection.responseCode})")
}
val metaInterval = connection.getHeaderFieldInt("icy-metaint", 0)
connection.inputStream.use { input ->
output.open().use { stream ->
if (metaInterval > 0) {
copyWithTitles(input, stream, metaInterval, incoming)
} else if (trigger != null) {
// Sans métadonnées, impossible de savoir quand le morceau passe.
throw IllegalStateException(
"${incoming.name} n'annonce pas ses titres : l'attente est impossible"
)
} else {
copyPlain(input, stream, incoming)
}
stream.flush()
}
}
} finally {
connection.disconnect()
}
}
// Fin du flux ou coupure réseau : ce qui a été capté reste valable.
finish()
}
}
/** Flux sans métadonnées : simple recopie. */
private suspend fun copyPlain(
input: java.io.InputStream,
output: java.io.OutputStream,
station: RadioStation,
) {
val buffer = ByteArray(32 * 1024)
var total = 0L
var lastNotified = 0L
while (currentCoroutineContext().isActive) {
val read = input.read(buffer)
if (read <= 0) break
output.write(buffer, 0, read)
total += read
if (total - lastNotified > NOTIFY_EVERY_BYTES) {
lastNotified = total
Recorder.progress(total)
notifyProgress(station, total)
}
}
Recorder.progress(total)
}
/**
* Flux ICY : `interval` octets d'audio, puis un bloc de métadonnées à retirer.
* Le premier titre rencontré nomme l'enregistrement ; les suivants alimentent la notification.
*/
private suspend fun copyWithTitles(
input: java.io.InputStream,
output: java.io.OutputStream,
interval: Int,
station: RadioStation,
) {
val wanted = trigger
val audio = ByteArray(interval)
var total = 0L
var lastNotified = 0L
// Sans titre attendu, on écrit dès la première seconde ; sinon on patiente.
var writing = wanted == null
var capturedTitle: String? = null
while (currentCoroutineContext().isActive) {
if (!input.readFully(audio, interval)) break
if (writing) {
output.write(audio)
total += interval
}
val lengthByte = input.read()
if (lengthByte < 0) break
val metaLength = lengthByte * 16
if (metaLength > 0) {
val meta = ByteArray(metaLength)
if (!input.readFully(meta, metaLength)) break
val announced = STREAM_TITLE
.find(String(meta, Charsets.UTF_8))
?.groupValues?.get(1)
?.trim()
?.takeIf { it.isNotBlank() }
if (announced != null) {
Recorder.title(announced)
when {
wanted == null -> if (firstTitle == null) firstTitle = announced
!writing && announced.contains(wanted, ignoreCase = true) -> {
// Le morceau attendu commence : on enregistre à partir d'ici.
writing = true
capturedTitle = announced
firstTitle = announced
Recorder.armed(announced)
}
writing && capturedTitle != null && announced != capturedTitle -> {
// Le morceau est terminé : on s'arrête sans attendre le suivant.
break
}
}
notifyProgress(station, total)
}
}
if (total - lastNotified > NOTIFY_EVERY_BYTES) {
lastNotified = total
Recorder.progress(total)
notifyProgress(station, total)
}
}
Recorder.progress(total)
}
/** Lit exactement [count] octets, ou renvoie false si le flux s'interrompt avant. */
private fun java.io.InputStream.readFully(target: ByteArray, count: Int): Boolean {
var filled = 0
while (filled < count) {
val read = read(target, filled, count - filled)
if (read < 0) return false
filled += read
}
return true
}
/** Clôt l'enregistrement et verse le fichier obtenu dans la bibliothèque. */
private fun finish() {
job?.cancel()
job = null
val output = sink
val recorded = station
val captured = firstTitle
sink = null
station = null
trigger = null
if (output != null && recorded != null) {
val elapsed = Recorder.status.value.elapsedMs
// Le titre annoncé par la station prime : c'est lui qu'on cherchait en enregistrant.
val title = captured ?: sinkTitle
val published = output.finish(title, elapsed)
if (published != null) {
val (uri, size) = published
val container = (application as NoxelyApp).container
val entry = MediaEntry(
id = "rec:${uri.hashCode()}",
source = SourceKind.RECORDING,
kind = MediaKind.AUDIO,
title = title,
subtitle = if (captured != null) recorded.name else "Enregistrement radio",
uri = uri,
artworkUri = recorded.faviconUrl,
durationMs = elapsed,
addedAt = System.currentTimeMillis(),
sizeBytes = size,
)
CoroutineScope(Dispatchers.IO).launch { container.imported.add(listOf(entry)) }
}
}
firstTitle = null
Recorder.stopped()
stopForeground(STOP_FOREGROUND_REMOVE)
stopSelf()
}
override fun onDestroy() {
scope.cancel()
super.onDestroy()
}
private fun startForegroundCompat(notification: Notification) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
startForeground(NOTIFICATION_ID, notification, ServiceInfo.FOREGROUND_SERVICE_TYPE_DATA_SYNC)
} else {
startForeground(NOTIFICATION_ID, notification)
}
}
private fun notifyProgress(station: RadioStation, bytes: Long) {
getSystemService(NotificationManager::class.java)
.notify(NOTIFICATION_ID, notification(station, bytes))
}
private fun notification(station: RadioStation, bytes: Long): Notification {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
getSystemService(NotificationManager::class.java).createNotificationChannel(
NotificationChannel(CHANNEL_ID, "Enregistrement radio", NotificationManager.IMPORTANCE_LOW)
)
}
val open = PendingIntent.getActivity(
this,
0,
Intent(this, MainActivity::class.java).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP),
PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT,
)
val stop = PendingIntent.getService(
this,
1,
Intent(this, RecordingService::class.java).setAction(ACTION_STOP),
PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT,
)
return NotificationCompat.Builder(this, CHANNEL_ID)
.setSmallIcon(R.drawable.ic_offline)
.setContentTitle(
if (Recorder.status.value.waitingFor != null) "En attente sur ${station.name}"
else "Enregistrement de ${station.name}"
)
.setContentText(
Recorder.status.value.currentTitle
?: if (bytes > 0) "%.1f Mo captés".format(bytes / 1_000_000.0) else "Démarrage…"
)
.setContentIntent(open)
.addAction(0, "Arrêter", stop)
.setOngoing(true)
.setPriority(NotificationCompat.PRIORITY_LOW)
.build()
}
private fun Intent.toStation(): RadioStation? {
val url = getStringExtra(EXTRA_URL) ?: return null
return RadioStation(
id = getStringExtra(EXTRA_ID).orEmpty(),
name = getStringExtra(EXTRA_NAME) ?: "Radio",
streamUrl = url,
codec = getStringExtra(EXTRA_CODEC).orEmpty(),
bitrate = getIntExtra(EXTRA_BITRATE, 0),
country = "",
tags = "",
faviconUrl = getStringExtra(EXTRA_FAVICON),
)
}
private fun RadioStation.extension(): String =
if (codec.equals("AAC", ignoreCase = true) || codec.startsWith("AAC", true)) "aac" else "mp3"
private fun String.sanitized(): String =
replace(Regex("[^\\p{L}\\p{N} _-]"), "").trim().replace(' ', '_').take(40).ifBlank { "radio" }
companion object {
private const val ACTION_START = "fr.tuxgyver.noxely.RECORD_START"
private const val ACTION_STOP = "fr.tuxgyver.noxely.RECORD_STOP"
private const val EXTRA_ID = "id"
private const val EXTRA_NAME = "name"
private const val EXTRA_URL = "url"
private const val EXTRA_CODEC = "codec"
private const val EXTRA_BITRATE = "bitrate"
private const val EXTRA_FAVICON = "favicon"
private const val EXTRA_TRIGGER = "trigger"
private const val NOTIFICATION_ID = 4401
private const val CHANNEL_ID = "cachette_recording"
private const val NOTIFY_EVERY_BYTES = 256 * 1024L
private const val MIN_USEFUL_BYTES = 16 * 1024L
private val STREAM_TITLE = Regex("StreamTitle='(.*?)';")
fun start(context: Context, station: RadioStation, whenTitleContains: String? = null) {
val intent = Intent(context, RecordingService::class.java)
.setAction(ACTION_START)
.putExtra(EXTRA_ID, station.id)
.putExtra(EXTRA_NAME, station.name)
.putExtra(EXTRA_URL, station.streamUrl)
.putExtra(EXTRA_CODEC, station.codec)
.putExtra(EXTRA_BITRATE, station.bitrate)
.putExtra(EXTRA_FAVICON, station.faviconUrl)
.putExtra(EXTRA_TRIGGER, whenTitleContains)
context.startForegroundService(intent)
}
fun stop(context: Context) {
context.startService(
Intent(context, RecordingService::class.java).setAction(ACTION_STOP)
)
}
}
}
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.radio
import android.content.ContentValues
@@ -1,101 +0,0 @@
package fr.tuxgyver.noxely.radio
import android.content.Context
import androidx.work.Constraints
import androidx.work.CoroutineWorker
import androidx.work.ExistingPeriodicWorkPolicy
import androidx.work.NetworkType
import androidx.work.PeriodicWorkRequestBuilder
import androidx.work.WorkManager
import androidx.work.WorkerParameters
import fr.tuxgyver.noxely.NoxelyApp
import kotlinx.coroutines.async
import kotlinx.coroutines.awaitAll
import kotlinx.coroutines.coroutineScope
import java.util.concurrent.TimeUnit
/**
* Résultat d'un balayage, tel que l'interface le rapporte.
*/
data class ScanOutcome(
val stationsProbed: Int,
val titlesRead: Int,
val matched: String?,
val matchedOn: String?,
)
/**
* Passe les stations en revue à la recherche des morceaux guettés.
*
* Chaque station doit être ouverte pour livrer son titre : le balayage est donc borné aux
* stations les plus écoutées, par paquets, et non lancé en continu.
*
* ⚠️ Un morceau dure trois à quatre minutes, et WorkManager n'autorise pas de tâche périodique
* plus fréquente qu'un quart d'heure. Le balayage automatique ne peut donc pas tout attraper :
* il repère ce qui passe au moment où il regarde. Le balayage manuel existe pour cela.
*/
class WatchScanner(
private val directory: RadioDirectory,
private val store: WatchStore,
) {
suspend fun scan(context: Context, stationLimit: Int = STATION_LIMIT): ScanOutcome {
val pending = store.pending()
if (pending.isEmpty()) return ScanOutcome(0, 0, null, null)
val stations = directory.popular().getOrNull()?.take(stationLimit).orEmpty()
var titles = 0
stations.chunked(CONCURRENCY).forEach { group ->
val heard = coroutineScope {
group.map { station -> async { station to directory.nowPlaying(station.streamUrl) } }
.awaitAll()
}
for ((station, title) in heard) {
if (title == null) continue
titles++
val hit = pending.firstOrNull { title.contains(it.query, ignoreCase = true) }
?: continue
// Un seul enregistrement à la fois : inutile d'en réclamer un second.
if (!Recorder.status.value.isRecording) {
RecordingService.start(context, station, whenTitleContains = hit.query)
}
store.markFound(hit.id, station.name, title)
store.markScanned(pending.map { it.id })
return ScanOutcome(stations.size, titles, title, station.name)
}
}
store.markScanned(pending.map { it.id })
return ScanOutcome(stations.size, titles, null, null)
}
companion object {
private const val STATION_LIMIT = 40
private const val CONCURRENCY = 4
private const val WORK_NAME = "noxely-watch-scan"
/** Un quart d'heure est le minimum autorisé pour une tâche périodique. */
fun schedule(context: Context) {
val request = PeriodicWorkRequestBuilder<WatchWorker>(15, TimeUnit.MINUTES)
.setConstraints(
Constraints.Builder().setRequiredNetworkType(NetworkType.CONNECTED).build()
)
.build()
WorkManager.getInstance(context).enqueueUniquePeriodicWork(
WORK_NAME,
ExistingPeriodicWorkPolicy.KEEP,
request,
)
}
}
}
class WatchWorker(context: Context, params: WorkerParameters) : CoroutineWorker(context, params) {
override suspend fun doWork(): Result {
val container = (applicationContext as NoxelyApp).container
if (container.watches.pending().isEmpty()) return Result.success()
runCatching { container.watchScanner.scan(applicationContext) }
return Result.success()
}
}
@@ -1,144 +0,0 @@
package fr.tuxgyver.noxely.radio
import android.app.Notification
import android.app.NotificationChannel
import android.app.NotificationManager
import android.app.PendingIntent
import android.app.Service
import android.content.Context
import android.content.Intent
import android.content.pm.ServiceInfo
import android.os.Build
import android.os.IBinder
import androidx.core.app.NotificationCompat
import fr.tuxgyver.noxely.MainActivity
import fr.tuxgyver.noxely.NoxelyApp
import fr.tuxgyver.noxely.R
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.Job
import kotlinx.coroutines.SupervisorJob
import kotlinx.coroutines.cancel
import kotlinx.coroutines.delay
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.StateFlow
import kotlinx.coroutines.flow.asStateFlow
import kotlinx.coroutines.isActive
import kotlinx.coroutines.launch
/**
* Veille active : balaie les stations en continu tant qu'un morceau est guetté.
*
* La tâche périodique du système ne descend pas sous le quart d'heure, quand un morceau dure
* trois à quatre minutes : elle ne peut donc qu'en manquer. Cette veille tourne en service de
* premier plan, visible et interruptible, et s'arrête d'elle-même quand il n'y a plus rien à
* guetter — il n'y a pas de raison de consommer pour rien.
*/
class WatchService : Service() {
private val scope = CoroutineScope(SupervisorJob() + Dispatchers.IO)
private var job: Job? = null
override fun onBind(intent: Intent?): IBinder? = null
override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
if (intent?.action == ACTION_STOP) {
finish()
return START_NOT_STICKY
}
if (job?.isActive == true) return START_STICKY
val container = (application as NoxelyApp).container
running.value = true
startForegroundCompat(notification(container.watches.pending().size, null))
job = scope.launch {
while (isActive) {
val pending = container.watches.pending()
if (pending.isEmpty()) break
val outcome = runCatching { container.watchScanner.scan(applicationContext) }.getOrNull()
notify(container.watches.pending().size, outcome?.matched)
if (container.watches.pending().isEmpty()) break
delay(SWEEP_INTERVAL_MS)
}
finish()
}
return START_STICKY
}
private fun finish() {
job?.cancel()
job = null
running.value = false
stopForeground(STOP_FOREGROUND_REMOVE)
stopSelf()
}
override fun onDestroy() {
running.value = false
scope.cancel()
super.onDestroy()
}
private fun startForegroundCompat(notification: Notification) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
startForeground(NOTIFICATION_ID, notification, ServiceInfo.FOREGROUND_SERVICE_TYPE_DATA_SYNC)
} else {
startForeground(NOTIFICATION_ID, notification)
}
}
private fun notify(pending: Int, lastMatch: String?) {
getSystemService(NotificationManager::class.java)
.notify(NOTIFICATION_ID, notification(pending, lastMatch))
}
private fun notification(pending: Int, lastMatch: String?): Notification {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
getSystemService(NotificationManager::class.java).createNotificationChannel(
NotificationChannel(CHANNEL_ID, "Veille radio", NotificationManager.IMPORTANCE_LOW)
)
}
val open = PendingIntent.getActivity(
this, 0,
Intent(this, MainActivity::class.java).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP),
PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT,
)
val stop = PendingIntent.getService(
this, 1,
Intent(this, WatchService::class.java).setAction(ACTION_STOP),
PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT,
)
return NotificationCompat.Builder(this, CHANNEL_ID)
.setSmallIcon(R.drawable.ic_offline)
.setContentTitle("Veille radio · $pending morceau(x) guetté(s)")
.setContentText(lastMatch?.let { "Dernier capté : $it" } ?: "Balayage toutes les 3 minutes")
.setContentIntent(open)
.addAction(0, "Arrêter", stop)
.setOngoing(true)
.setPriority(NotificationCompat.PRIORITY_LOW)
.build()
}
companion object {
private const val ACTION_STOP = "fr.tuxgyver.noxely.WATCH_STOP"
private const val NOTIFICATION_ID = 4501
private const val CHANNEL_ID = "noxely_watch"
/** Trois minutes : assez serré pour croiser un morceau, assez large pour la batterie. */
private const val SWEEP_INTERVAL_MS = 180_000L
private val running = MutableStateFlow(false)
val isRunning: StateFlow<Boolean> = running.asStateFlow()
fun start(context: Context) {
context.startForegroundService(Intent(context, WatchService::class.java))
}
fun stop(context: Context) {
context.startService(Intent(context, WatchService::class.java).setAction(ACTION_STOP))
}
}
}
@@ -1,90 +0,0 @@
package fr.tuxgyver.noxely.radio
import android.content.Context
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.StateFlow
import kotlinx.coroutines.flow.asStateFlow
import kotlinx.coroutines.launch
import kotlinx.coroutines.sync.Mutex
import kotlinx.coroutines.sync.withLock
import kotlinx.coroutines.withContext
import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.json.Json
import java.io.File
import java.util.UUID
/** Un morceau guetté sur l'ensemble des stations. */
@Serializable
data class Watch(
val id: String,
val query: String,
val createdAt: Long,
/** Renseignés une fois le morceau capté. */
val foundAt: Long? = null,
val foundOn: String? = null,
val foundTitle: String? = null,
val lastScanAt: Long? = null,
val scans: Int = 0,
) {
val isFound: Boolean get() = foundAt != null
}
/** Persistance des guets, sur le même principe que les playlists. */
class WatchStore(context: Context, scope: CoroutineScope) {
private val file = File(context.filesDir, "watches.json")
private val json = Json { ignoreUnknownKeys = true }
private val mutex = Mutex()
private val _watches = MutableStateFlow<List<Watch>>(emptyList())
val watches: StateFlow<List<Watch>> = _watches.asStateFlow()
init {
scope.launch { _watches.value = read() }
}
suspend fun add(query: String) = mutate { current ->
val cleaned = query.trim()
if (cleaned.isBlank() || current.any { it.query.equals(cleaned, true) && !it.isFound }) current
else current + Watch(UUID.randomUUID().toString(), cleaned, System.currentTimeMillis())
}
suspend fun remove(id: String) = mutate { current -> current.filterNot { it.id == id } }
suspend fun markFound(id: String, station: String, title: String) = mutate { current ->
current.map {
if (it.id == id) it.copy(foundAt = System.currentTimeMillis(), foundOn = station, foundTitle = title)
else it
}
}
suspend fun markScanned(ids: Collection<String>) = mutate { current ->
val now = System.currentTimeMillis()
current.map { if (it.id in ids) it.copy(lastScanAt = now, scans = it.scans + 1) else it }
}
/** Les guets encore en attente, seuls concernés par un balayage. */
fun pending(): List<Watch> = _watches.value.filterNot { it.isFound }
private suspend fun mutate(transform: (List<Watch>) -> List<Watch>) = mutex.withLock {
val updated = transform(_watches.value)
if (updated != _watches.value) {
_watches.value = updated
write(updated)
}
}
private suspend fun read(): List<Watch> = withContext(Dispatchers.IO) {
if (!file.exists()) return@withContext emptyList()
runCatching { json.decodeFromString<List<Watch>>(file.readText()) }.getOrElse { emptyList() }
}
private suspend fun write(watches: List<Watch>) = withContext(Dispatchers.IO) {
val tmp = File(file.parentFile, "${file.name}.tmp")
tmp.writeText(json.encodeToString(watches))
tmp.renameTo(file)
}
}
@@ -1,158 +0,0 @@
package fr.tuxgyver.noxely.sources
import fr.tuxgyver.noxely.model.MediaEntry
import fr.tuxgyver.noxely.model.MediaKind
import fr.tuxgyver.noxely.model.SourceKind
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
import kotlinx.serialization.json.Json
import kotlinx.serialization.json.JsonArray
import kotlinx.serialization.json.JsonObject
import kotlinx.serialization.json.JsonPrimitive
import kotlinx.serialization.json.jsonObject
import java.net.URLEncoder
/**
* Recherche dans archive.org.
*
* La recherche ne renvoie que des identifiants ; le fichier réellement lisible n'est déterminé
* qu'au moment où l'utilisateur choisit un résultat, pour ne pas interroger les métadonnées de
* trente éléments dont vingt-neuf seront ignorés.
*/
class ArchiveOrgCatalog(
override val id: CatalogId = CatalogId.ARCHIVE,
/**
* Collections auxquelles se restreindre. Vide : tout archive.org.
* `netlabels` et `freemusicarchive` ne contiennent que des publications sous licence libre,
* ce qui donne un fonds indépendant sans les dépôts de titres commerciaux qu'on croise
* ailleurs sur le site.
*/
private val collections: List<String> = emptyList(),
) : Catalog {
override val languages = COMMON_LANGUAGES
private val json = Json { ignoreUnknownKeys = true }
override suspend fun search(query: String, language: String?): Result<List<CatalogItem>> =
withContext(Dispatchers.IO) {
runCatching {
// Les éléments « access-restricted » répondent 401 au téléchargement : on les écarte
// dès la recherche plutôt que de les proposer puis d'échouer.
val languageClause = language?.let { " AND language:($it)" }.orEmpty()
val collectionClause =
collections.takeIf { it.isNotEmpty() }
?.joinToString(" OR ")
?.let { " AND collection:($it)" }
.orEmpty()
val q = URLEncoder.encode(
"($query) AND mediatype:(audio OR movies)$languageClause$collectionClause" +
" AND NOT access-restricted-item:true",
"UTF-8",
)
val url = "https://archive.org/advancedsearch.php?q=$q" +
"&fl%5B%5D=identifier&fl%5B%5D=title&fl%5B%5D=creator&fl%5B%5D=mediatype&fl%5B%5D=item_size" +
"&rows=30&page=1&output=json"
val body = fetch(url)
val docs = json.parseToJsonElement(body).jsonObject["response"]
?.jsonObject?.get("docs") as? JsonArray
?: throw IllegalStateException("Réponse inattendue d'archive.org")
docs.mapNotNull { element ->
val doc = element as? JsonObject ?: return@mapNotNull null
val identifier = doc.text("identifier") ?: return@mapNotNull null
CatalogItem(
id = identifier,
title = doc.text("title") ?: identifier,
subtitle = doc.text("creator") ?: "Internet Archive",
artworkUri = "https://archive.org/services/img/$identifier",
hint = if (doc.text("mediatype") == "movies") "Vidéo" else "Audio",
sizeBytes = doc.text("item_size")?.toLongOrNull(),
)
}
}
}
override suspend fun tracks(item: CatalogItem): Result<List<MediaEntry>> = withContext(Dispatchers.IO) {
runCatching {
val metadata = json.parseToJsonElement(fetch("https://archive.org/metadata/${item.id}")).jsonObject
if (metadata["metadata"]?.jsonObject?.text("access-restricted-item") == "true") {
throw IllegalStateException("« ${item.title} » est en accès restreint sur archive.org")
}
val wantsVideo = item.hint == "Vidéo"
val extensions = if (wantsVideo) VIDEO_EXTENSIONS else AUDIO_EXTENSIONS
val files = (metadata["files"] as? JsonArray).orEmpty().mapNotNull { it as? JsonObject }
val playable = files.filter { file ->
val name = file.text("name").orEmpty().lowercase()
extensions.any { name.endsWith(it) }
}
if (playable.isEmpty()) {
throw IllegalStateException(
"Aucun fichier ${if (wantsVideo) "vidéo" else "audio"} lisible dans « ${item.title} »"
)
}
// Un élément expose l'original et ses dérivés du même morceau. On regroupe par nom de
// base et on garde le plus léger de chaque groupe : autant de pistes que d'œuvres,
// pas autant que de formats.
playable.groupBy { it.text("name")!!.substringBeforeLast('.').lowercase() }
.values
.mapNotNull { variants ->
variants.minByOrNull { it.text("size")?.toLongOrNull() ?: Long.MAX_VALUE }
}
.sortedBy { it.text("name") }
.map { file ->
val name = file.text("name")!!
val seconds = file.text("length")?.substringBefore('.')?.toLongOrNull() ?: 0L
MediaEntry(
id = stableId("ia:", "${item.id}/$name"),
source = SourceKind.URL,
kind = if (wantsVideo) MediaKind.VIDEO else MediaKind.AUDIO,
title = file.text("title") ?: name.substringBeforeLast('.'),
subtitle = item.title,
uri = "https://archive.org/download/${item.id}/${encodePath(name)}",
artworkUri = item.artworkUri,
durationMs = seconds * 1000,
addedAt = System.currentTimeMillis(),
sizeBytes = file.text("size")?.toLongOrNull(),
)
}
}
}
/** Encode le nom de fichier sans toucher aux séparateurs de chemin. */
private fun encodePath(name: String): String =
name.split('/').joinToString("/") {
URLEncoder.encode(it, "UTF-8").replace("+", "%20")
}
private fun fetch(url: String): String {
val connection = openConnection(url)
return try {
if (connection.responseCode !in 200..299) {
throw IllegalStateException("archive.org a répondu ${connection.responseCode}")
}
connection.inputStream.bufferedReader().readText()
} finally {
connection.disconnect()
}
}
private companion object {
val AUDIO_EXTENSIONS = listOf(".mp3", ".m4a", ".ogg", ".opus", ".flac", ".wav")
val VIDEO_EXTENSIONS = listOf(".mp4", ".m4v", ".webm", ".ogv")
fun JsonArray?.orEmpty(): JsonArray = this ?: JsonArray(emptyList())
}
}
/** archive.org renvoie tantôt une chaîne, tantôt un tableau : on prend la première valeur utile. */
internal fun JsonObject.text(key: String): String? = when (val value = this[key]) {
is JsonPrimitive -> value.content.takeIf { it.isNotBlank() }
is JsonArray -> value.firstOrNull()?.let { (it as? JsonPrimitive)?.content }?.takeIf { it.isNotBlank() }
else -> null
}
@@ -1,77 +0,0 @@
package fr.tuxgyver.noxely.sources
import fr.tuxgyver.noxely.model.MediaEntry
/** Un résultat de recherche : un album, un livre ou un morceau, pas encore un fichier. */
data class CatalogItem(
val id: String,
val title: String,
val subtitle: String,
val artworkUri: String? = null,
val hint: String = "",
/** Taille de l'ensemble, quand le catalogue l'annonce. */
val sizeBytes: Long? = null,
)
/** Langue proposée au filtrage. [code] est la valeur attendue par l'API du catalogue. */
data class CatalogLanguage(val code: String, val label: String)
/** Catalogue public interrogeable sans compte ni clé d'API. */
interface Catalog {
val id: CatalogId
/** Vide si le catalogue ne distingue pas les langues (la musique instrumentale, typiquement). */
val languages: List<CatalogLanguage> get() = emptyList()
suspend fun search(query: String, language: String? = null): Result<List<CatalogItem>>
/**
* Les pistes d'un résultat, avec leur taille.
*
* Un album ou un livre en compte plusieurs : c'est à l'utilisateur de choisir lesquelles il
* emporte, pas à l'application de décider pour lui.
*/
suspend fun tracks(item: CatalogItem): Result<List<MediaEntry>>
}
enum class CatalogId(
val title: String,
val description: String,
val license: String,
val suggestion: String,
) {
ARCHIVE(
title = "Internet Archive",
description = "Musique, concerts et films versés au domaine public ou sous licence libre.",
license = "Domaine public / Creative Commons",
suggestion = "Grateful Dead",
),
LIBRIVOX(
title = "LibriVox",
description = "Livres audio lus par des bénévoles, tous dans le domaine public.",
license = "Domaine public",
suggestion = "Jules Verne",
),
UNDERGROUND(
title = "Underground",
description = "Netlabels et Free Music Archive : des dizaines de milliers de morceaux d'artistes indépendants, publiés sous licence libre.",
license = "Creative Commons / netlabels",
suggestion = "ambient",
),
WIKIMEDIA(
title = "Wikimedia Commons",
description = "Enregistrements classiques, archives sonores et musique libre hébergés par Wikimedia.",
license = "Domaine public / Creative Commons",
suggestion = "Chopin",
),
}
/** Langues les plus fournies, communes à LibriVox et archive.org. */
val COMMON_LANGUAGES = listOf(
CatalogLanguage("French", "Français"),
CatalogLanguage("English", "Anglais"),
CatalogLanguage("German", "Allemand"),
CatalogLanguage("Spanish", "Espagnol"),
CatalogLanguage("Italian", "Italien"),
CatalogLanguage("Dutch", "Néerlandais"),
)
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.sources
import java.net.HttpURLConnection
@@ -1,106 +0,0 @@
package fr.tuxgyver.noxely.sources
import fr.tuxgyver.noxely.model.MediaEntry
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.async
import kotlinx.coroutines.awaitAll
import kotlinx.coroutines.coroutineScope
import kotlinx.coroutines.withContext
import kotlinx.serialization.json.Json
import kotlinx.serialization.json.JsonArray
import kotlinx.serialization.json.JsonObject
import kotlinx.serialization.json.jsonObject
import java.net.URLEncoder
/**
* Recherche dans LibriVox.
*
* L'API a deux pièges, tous deux vérifiés contre le service réel :
* le champ `title` fait une correspondance **exacte** sauf s'il est préfixé par `^`
* (`title=Alice` ne donne rien, `title=^Alice` donne vingt-trois livres), et le champ `author`
* ne matche que le **nom de famille** (`author=Jules Verne` ne donne rien, `author=Verne` si).
* Un « aucun résultat » se présente enfin sous la forme d'un HTTP 404, pas d'une liste vide.
*
* D'où trois interrogations combinées et dédoublonnées, plutôt qu'une seule qui échouerait.
*
* Chaque livre publie un flux RSS : la résolution réutilise l'import de podcast plutôt que de
* redécrire un parcours de chapitres.
*/
class LibriVoxCatalog(private val rss: RssImporter) : Catalog {
override val id = CatalogId.LIBRIVOX
override val languages = COMMON_LANGUAGES
private val json = Json { ignoreUnknownKeys = true }
override suspend fun search(query: String, language: String?): Result<List<CatalogItem>> =
withContext(Dispatchers.IO) {
runCatching {
// Le paramètre `language` de l'API est accepté puis ignoré : vérifié, `language=French`
// seul renvoie des livres anglais. Le tri se fait donc sur le champ `language` de
// chaque livre, et on demande davantage de résultats pour qu'il en reste après filtrage.
val limit = if (language == null) 25 else 100
val cleaned = query.trim()
val term = URLEncoder.encode(cleaned, "UTF-8")
val words = cleaned.split(Regex("\\s+")).filter { it.isNotBlank() }
val criteria = buildList {
add("title=^$term")
add("author=$term")
// « Jules Verne » ne matche que sur « Verne » : on retente avec le nom de famille.
if (words.size > 1) add("author=${URLEncoder.encode(words.last(), "UTF-8")}")
}
// Les trois critères sont indépendants : les lancer en parallèle ramène l'attente
// à celle de la requête la plus lente, au lieu de leur somme.
coroutineScope {
criteria.map { async { books(it, limit, language) } }.awaitAll()
}.flatten().distinctBy { it.id }
}
}
override suspend fun tracks(item: CatalogItem): Result<List<MediaEntry>> =
rss.import(item.id).map { feed -> feed.episodes }
private fun books(criterion: String, limit: Int, language: String?): List<CatalogItem> {
val url = "https://librivox.org/api/feed/audiobooks/?format=json&limit=$limit&$criterion"
// Le service met 14 à 16 secondes à répondre, quelle que soit la taille demandée :
// c'est sa latence propre, pas le volume. D'où une patience adaptée.
val connection = openConnection(url, readTimeoutMs = 45_000)
val body = try {
when (connection.responseCode) {
// LibriVox répond 404 quand le critère ne donne rien : ce n'est pas une panne.
404 -> return emptyList()
in 200..299 -> connection.inputStream.bufferedReader().readText()
else -> throw IllegalStateException("LibriVox a répondu ${connection.responseCode}")
}
} finally {
connection.disconnect()
}
val books = json.parseToJsonElement(body).jsonObject["books"] as? JsonArray ?: return emptyList()
return books.mapNotNull { element ->
val book = element as? JsonObject ?: return@mapNotNull null
if (language != null && !book.text("language").equals(language, ignoreCase = true)) {
return@mapNotNull null
}
val feed = book.text("url_rss") ?: return@mapNotNull null
CatalogItem(
id = feed,
title = book.text("title") ?: "Livre audio",
subtitle = book.authors(),
hint = book.text("totaltime")?.let { "Livre audio · $it" } ?: "Livre audio",
)
}
}
private fun JsonObject.authors(): String {
val authors = this["authors"] as? JsonArray ?: return "LibriVox"
return authors.mapNotNull { it as? JsonObject }
.joinToString(", ") { author ->
listOfNotNull(author.text("first_name"), author.text("last_name")).joinToString(" ")
}
.ifBlank { "LibriVox" }
}
}
@@ -1,143 +0,0 @@
package fr.tuxgyver.noxely.sources
import android.util.Xml
import fr.tuxgyver.noxely.model.MediaEntry
import fr.tuxgyver.noxely.model.MediaKind
import fr.tuxgyver.noxely.model.SourceKind
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
import org.xmlpull.v1.XmlPullParser
import java.text.SimpleDateFormat
import java.util.Locale
data class PodcastFeed(
val title: String,
val artworkUri: String?,
val episodes: List<MediaEntry>,
)
/** Importe un flux RSS de podcast : chaque `<enclosure>` devient une entrée téléchargeable. */
class RssImporter {
suspend fun import(feedUrl: String): Result<PodcastFeed> = withContext(Dispatchers.IO) {
val url = feedUrl.trim()
if (!url.startsWith("http://") && !url.startsWith("https://")) {
return@withContext Result.failure(IllegalArgumentException("Le lien doit commencer par http:// ou https://"))
}
runCatching {
val connection = openConnection(url)
try {
if (connection.responseCode !in 200..299) {
throw IllegalStateException("Le serveur a répondu ${connection.responseCode}")
}
parse(connection.inputStream.bufferedReader().readText())
} finally {
connection.disconnect()
}
}
}
private fun parse(xml: String): PodcastFeed {
val parser = Xml.newPullParser().apply {
setFeature(XmlPullParser.FEATURE_PROCESS_NAMESPACES, false)
setInput(xml.reader())
}
var feedTitle = ""
var feedImage: String? = null
val episodes = mutableListOf<MediaEntry>()
var item: Draft? = null
var event = parser.eventType
while (event != XmlPullParser.END_DOCUMENT) {
when (event) {
XmlPullParser.START_TAG -> when (parser.name) {
"item", "entry" -> item = Draft()
"title" -> {
val value = parser.textOrEmpty()
if (item != null) item.title = value else if (feedTitle.isEmpty()) feedTitle = value
}
"enclosure" -> if (item != null) {
item.url = parser.getAttributeValue(null, "url")
item.type = parser.getAttributeValue(null, "type").orEmpty()
}
"itunes:image" -> {
val href = parser.getAttributeValue(null, "href")
if (item != null) item.image = href else if (feedImage == null) feedImage = href
}
"itunes:duration" -> if (item != null) item.duration = parser.textOrEmpty()
"pubDate" -> if (item != null) item.pubDate = parser.textOrEmpty()
"url" -> if (item == null && feedImage == null) feedImage = parser.textOrEmpty()
}
XmlPullParser.END_TAG -> if (parser.name == "item" || parser.name == "entry") {
item?.toEntry(feedTitle, feedImage)?.let(episodes::add)
item = null
}
}
event = parser.next()
}
if (episodes.isEmpty()) {
throw IllegalStateException("Aucun épisode téléchargeable trouvé dans ce flux")
}
return PodcastFeed(
title = feedTitle.ifEmpty { "Podcast" },
artworkUri = feedImage,
episodes = episodes.take(MAX_EPISODES),
)
}
private class Draft {
var title: String = ""
var url: String? = null
var type: String = ""
var image: String? = null
var duration: String = ""
var pubDate: String = ""
fun toEntry(feedTitle: String, feedImage: String?): MediaEntry? {
val mediaUrl = url?.takeIf { it.isNotBlank() } ?: return null
return MediaEntry(
id = stableId("pod:", mediaUrl),
source = SourceKind.PODCAST,
kind = if (type.startsWith("video/")) MediaKind.VIDEO else MediaKind.AUDIO,
title = title.ifBlank { "Épisode" },
subtitle = feedTitle.ifBlank { "Podcast" },
uri = mediaUrl,
artworkUri = image ?: feedImage,
durationMs = parseDuration(duration),
addedAt = parseDate(pubDate),
)
}
}
private companion object {
const val MAX_EPISODES = 100
fun XmlPullParser.textOrEmpty(): String =
runCatching { nextText().trim() }.getOrDefault("")
/** `1:02:03`, `12:34` ou un nombre de secondes. */
fun parseDuration(raw: String): Long {
if (raw.isBlank()) return 0L
val parts = raw.split(':').mapNotNull { it.trim().toLongOrNull() }
return when (parts.size) {
1 -> parts[0] * 1000
2 -> (parts[0] * 60 + parts[1]) * 1000
3 -> (parts[0] * 3600 + parts[1] * 60 + parts[2]) * 1000
else -> 0L
}
}
fun parseDate(raw: String): Long {
if (raw.isBlank()) return System.currentTimeMillis()
val formats = listOf("EEE, dd MMM yyyy HH:mm:ss Z", "EEE, dd MMM yyyy HH:mm:ss zzz")
for (pattern in formats) {
runCatching { SimpleDateFormat(pattern, Locale.US).parse(raw)?.time }
.getOrNull()?.let { return it }
}
return System.currentTimeMillis()
}
}
}
@@ -1,65 +0,0 @@
package fr.tuxgyver.noxely.sources
import android.net.Uri
import androidx.core.net.toUri
import fr.tuxgyver.noxely.model.MediaEntry
import fr.tuxgyver.noxely.model.MediaKind
import fr.tuxgyver.noxely.model.SourceKind
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
/** Importe un lien direct vers un fichier média (mp3, m4a, mp4, webm…). */
class UrlImporter {
suspend fun import(rawUrl: String): Result<MediaEntry> = withContext(Dispatchers.IO) {
val url = rawUrl.trim()
if (!url.startsWith("http://") && !url.startsWith("https://")) {
return@withContext Result.failure(IllegalArgumentException("Le lien doit commencer par http:// ou https://"))
}
runCatching {
val connection = openConnection(url, "HEAD")
val contentType = try {
if (connection.responseCode !in 200..299) {
throw IllegalStateException("Le serveur a répondu ${connection.responseCode}")
}
connection.contentType.orEmpty()
} finally {
connection.disconnect()
}
val kind = kindOf(contentType, url)
?: throw IllegalStateException("Ce lien ne pointe pas vers un fichier audio ou vidéo")
val name = url.toUri().lastPathSegment
?.substringBeforeLast('.')
?.replace(Regex("[_-]+"), " ")
?.trim()
?.takeIf { it.isNotBlank() }
?: "Média importé"
MediaEntry(
id = stableId("url:", url),
source = SourceKind.URL,
kind = kind,
title = name,
subtitle = url.toUri().host ?: "Lien direct",
uri = url,
addedAt = System.currentTimeMillis(),
)
}
}
private fun kindOf(contentType: String, url: String): MediaKind? {
val mime = contentType.substringBefore(';').trim().lowercase()
return when {
mime.startsWith("video/") -> MediaKind.VIDEO
mime.startsWith("audio/") -> MediaKind.AUDIO
mime == "application/vnd.apple.mpegurl" || mime == "application/x-mpegurl" -> MediaKind.VIDEO
else -> when (url.substringAfterLast('.', "").lowercase().substringBefore('?')) {
"mp3", "m4a", "aac", "ogg", "opus", "flac", "wav" -> MediaKind.AUDIO
"mp4", "mkv", "webm", "m4v", "mov" -> MediaKind.VIDEO
else -> null
}
}
}
}
@@ -1,96 +0,0 @@
package fr.tuxgyver.noxely.sources
import fr.tuxgyver.noxely.model.MediaEntry
import fr.tuxgyver.noxely.model.MediaKind
import fr.tuxgyver.noxely.model.SourceKind
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
import kotlinx.serialization.json.Json
import kotlinx.serialization.json.JsonObject
import kotlinx.serialization.json.jsonArray
import kotlinx.serialization.json.jsonObject
import java.net.URLEncoder
/**
* Recherche de fichiers audio sur Wikimedia Commons.
*
* Retenu après avoir écarté deux candidats vérifiés : Openverse refuse désormais l'accès anonyme
* (401 sur huit requêtes sur huit) et ccMixter exige un en-tête `Referer` que Media3 ne permet pas
* de poser par téléchargement. Commons, lui, sert ses fichiers directement depuis
* upload.wikimedia.org, sans clé ni en-tête particulier, et annonce leur taille.
*
* Chaque résultat est déjà un fichier unique : la liste de pistes n'en contient donc qu'une.
*/
class WikimediaCatalog : Catalog {
override val id = CatalogId.WIKIMEDIA
private val json = Json { ignoreUnknownKeys = true }
override suspend fun search(query: String, language: String?): Result<List<CatalogItem>> =
withContext(Dispatchers.IO) {
runCatching {
val search = URLEncoder.encode("filetype:audio ${query.trim()}", "UTF-8")
val url = "https://commons.wikimedia.org/w/api.php?action=query&format=json" +
"&generator=search&gsrsearch=$search&gsrnamespace=6&gsrlimit=30" +
"&prop=imageinfo&iiprop=url%7Csize%7Cmime%7Cextmetadata"
val connection = openConnection(url, readTimeoutMs = 30_000)
val body = try {
if (connection.responseCode !in 200..299) {
throw IllegalStateException("Commons a répondu ${connection.responseCode}")
}
connection.inputStream.bufferedReader().readText()
} finally {
connection.disconnect()
}
val pages = json.parseToJsonElement(body).jsonObject["query"]
?.jsonObject?.get("pages")?.jsonObject
?: return@runCatching emptyList()
pages.values.mapNotNull { element ->
val page = element as? JsonObject ?: return@mapNotNull null
val info = page["imageinfo"]?.jsonArray?.firstOrNull()?.jsonObject
?: return@mapNotNull null
val fileUrl = info.text("url") ?: return@mapNotNull null
if (!PLAYABLE.any { fileUrl.substringBefore('?').lowercase().endsWith(it) }) {
return@mapNotNull null
}
val licence = info["extmetadata"]?.jsonObject
?.get("LicenseShortName")?.jsonObject?.text("value")
CatalogItem(
id = fileUrl,
// Les titres Commons sont préfixés « File: » : inutile à l'écran.
title = page.text("title")?.removePrefix("File:")?.substringBeforeLast('.')
?: "Sans titre",
subtitle = "Wikimedia Commons",
hint = licence ?: "Domaine public / CC",
sizeBytes = info.text("size")?.toLongOrNull(),
)
}
}
}
override suspend fun tracks(item: CatalogItem): Result<List<MediaEntry>> = Result.success(
listOf(
MediaEntry(
id = stableId("wm:", item.id),
source = SourceKind.URL,
kind = MediaKind.AUDIO,
title = item.title,
subtitle = item.subtitle,
uri = item.id,
addedAt = System.currentTimeMillis(),
sizeBytes = item.sizeBytes,
)
)
)
private companion object {
/** Formats que Media3 sait lire parmi ceux que Commons héberge. */
val PLAYABLE = listOf(".ogg", ".oga", ".opus", ".flac", ".wav", ".mp3", ".m4a")
}
}
@@ -0,0 +1,76 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.sync
import android.content.Context
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.StateFlow
import kotlinx.coroutines.flow.asStateFlow
import kotlinx.coroutines.launch
import kotlinx.coroutines.withContext
import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.json.Json
import java.io.File
/** Coordonnées du serveur et état de la dernière synchronisation. */
@Serializable
data class ServerConfig(
val baseUrl: String = "",
val token: String = "",
/** Horodatage du dernier média reçu : le serveur ne renvoie que ce qui a changé après. */
val cursor: Long = 0L,
val lastSyncAt: Long = 0L,
val lastResult: String = "",
) {
val isConfigured: Boolean get() = baseUrl.isNotBlank() && token.isNotBlank()
}
/**
* Réglages du serveur, persistés localement.
*
* Le jeton ne quitte jamais l'appareil autrement que dans l'en-tête des requêtes vers le serveur
* désigné : c'est la seule adresse que l'application contacte une fois la bascule faite.
*/
class ServerSettings(context: Context, private val scope: CoroutineScope) {
private val file = File(context.filesDir, "server.json")
private val json = Json { ignoreUnknownKeys = true }
private val _config = MutableStateFlow(ServerConfig())
val config: StateFlow<ServerConfig> = _config.asStateFlow()
init {
scope.launch { _config.value = read() }
}
suspend fun update(transform: (ServerConfig) -> ServerConfig) {
val updated = transform(_config.value)
_config.value = updated
write(updated)
}
private suspend fun read(): ServerConfig = withContext(Dispatchers.IO) {
if (!file.exists()) return@withContext ServerConfig()
runCatching { json.decodeFromString<ServerConfig>(file.readText()) }
.getOrElse { ServerConfig() }
}
private suspend fun write(config: ServerConfig) = withContext(Dispatchers.IO) {
val tmp = File(file.parentFile, "${file.name}.tmp")
tmp.writeText(json.encodeToString(config))
tmp.renameTo(file)
}
}
@@ -0,0 +1,195 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.sync
import android.content.Context
import android.os.Build
import fr.tuxgyver.noxely.library.ImportedStore
import fr.tuxgyver.noxely.model.MediaEntry
import fr.tuxgyver.noxely.model.MediaKind
import fr.tuxgyver.noxely.model.SourceKind
import fr.tuxgyver.noxely.radio.RecordingSink
import fr.tuxgyver.noxely.sources.openConnection
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
import kotlinx.serialization.json.Json
import kotlinx.serialization.json.JsonArray
import kotlinx.serialization.json.JsonObject
import kotlinx.serialization.json.jsonObject
import kotlinx.serialization.json.jsonPrimitive
import java.net.URLEncoder
data class SyncResult(val added: Int, val failed: Int, val message: String)
/**
* Client de synchronisation.
*
* Le téléphone ne cherche plus, ne guette plus et n'enregistre plus : il demande au serveur ce
* qui est apparu depuis son dernier passage, télécharge les fichiers prêts, et se rendort. C'est
* là qu'est l'économie de batterie — tout le travail d'écoute et de collecte a migré ailleurs.
*/
class SyncClient(
private val context: Context,
private val settings: ServerSettings,
private val imported: ImportedStore,
) {
private val json = Json { ignoreUnknownKeys = true }
/** Vérifie que le serveur répond et que le jeton est accepté. */
suspend fun probe(baseUrl: String, token: String): Result<String> = withContext(Dispatchers.IO) {
runCatching {
val name = request("${baseUrl.trimEnd('/')}/api/health", token = null)
.let { json.parseToJsonElement(it).jsonObject }
.let { "${it["name"]?.jsonPrimitive?.content} ${it["version"]?.jsonPrimitive?.content}" }
// Une réponse publique ne prouve rien sur le jeton : on interroge aussi un point protégé.
request("${baseUrl.trimEnd('/')}/api/library?since=0", token)
name
}
}
/**
* Récupère le jeton auprès du serveur, pendant sa fenêtre d'appairage.
*
* Le téléphone ne peut pas deviner un jeton — c'est ce qu'il protège. Il peut en revanche le
* recevoir, à condition que quelqu'un ait ouvert la fenêtre depuis l'interface du serveur, et
* que la demande vienne du réseau local.
*/
suspend fun pair(baseUrl: String): Result<String> = withContext(Dispatchers.IO) {
runCatching {
val base = baseUrl.trim().trimEnd('/')
val connection = openConnection("$base/api/pair", readTimeoutMs = 20_000).apply {
requestMethod = "POST"
doOutput = true
setRequestProperty("Content-Type", "application/json")
// Le nom du modèle rend l'appareil reconnaissable dans la liste du serveur.
val name = (Build.MANUFACTURER + " " + Build.MODEL).trim()
outputStream.use { it.write(("{" + "\"name\":\"" + name + "\"}").toByteArray()) }
}
val body = try {
when (connection.responseCode) {
403 -> throw IllegalStateException(
connection.errorStream?.bufferedReader()?.readText()
?.let { json.parseToJsonElement(it).jsonObject.text("detail") }
?: "Aucun appairage en cours sur le serveur"
)
in 200..299 -> connection.inputStream.bufferedReader().readText()
else -> throw IllegalStateException("Le serveur a répondu ${connection.responseCode}")
}
} finally {
connection.disconnect()
}
val payload = json.parseToJsonElement(body).jsonObject
val token = payload.text("token") ?: throw IllegalStateException("Réponse sans jeton")
settings.update { it.copy(baseUrl = base, token = token) }
"${payload.text("name")} ${payload.text("version")}"
}
}
suspend fun sync(): SyncResult = withContext(Dispatchers.IO) {
val config = settings.config.value
if (!config.isConfigured) return@withContext SyncResult(0, 0, "Serveur non configuré")
val base = config.baseUrl.trimEnd('/')
val body = runCatching { request("$base/api/library?since=${config.cursor}", config.token) }
.getOrElse { return@withContext SyncResult(0, 0, it.message ?: "Serveur injoignable") }
val payload = json.parseToJsonElement(body).jsonObject
val items = (payload["items"] as? JsonArray).orEmpty()
val cursor = payload["cursor"]?.jsonPrimitive?.content?.toLongOrNull() ?: config.cursor
var added = 0
var failed = 0
for (element in items) {
val item = element as? JsonObject ?: continue
val id = item.text("id") ?: continue
val title = item.text("title") ?: "Sans titre"
val mime = item.text("mime") ?: "audio/mpeg"
val extension = if (mime.contains("aac")) "aac" else if (mime.contains("mp4")) "mp4" else "mp3"
val sink = RecordingSink(context, "${title.take(80)}.$extension", mime)
val outcome = runCatching {
val connection = openConnection("$base/api/media/$id/file", readTimeoutMs = 120_000)
.apply { setRequestProperty("X-Noxely-Token", config.token) }
try {
if (connection.responseCode !in 200..299) {
throw IllegalStateException("HTTP ${connection.responseCode}")
}
connection.inputStream.use { input ->
sink.open().use { output -> input.copyTo(output) }
}
} finally {
connection.disconnect()
}
sink.finish(title, item.text("duration_ms")?.toLongOrNull() ?: 0L)
}.getOrNull()
if (outcome == null) {
sink.abort()
failed++
continue
}
val (uri, size) = outcome
imported.add(
listOf(
MediaEntry(
id = "srv:$id",
source = SourceKind.SERVER,
kind = if (mime.startsWith("video")) MediaKind.VIDEO else MediaKind.AUDIO,
title = title,
subtitle = item.text("artist")?.takeIf { it.isNotBlank() } ?: "Serveur Noxely",
uri = uri,
artworkUri = item.text("artwork_url"),
durationMs = item.text("duration_ms")?.toLongOrNull() ?: 0L,
addedAt = System.currentTimeMillis(),
sizeBytes = size,
)
)
)
added++
}
// Le curseur n'avance que si tout est passé : un échec sera retenté au prochain tour.
settings.update {
it.copy(
cursor = if (failed == 0) cursor else it.cursor,
lastSyncAt = System.currentTimeMillis(),
lastResult = when {
added == 0 && failed == 0 -> "À jour"
failed == 0 -> "$added titre(s) reçus"
else -> "$added reçus, $failed en échec"
},
)
}
SyncResult(added, failed, settings.config.value.lastResult)
}
private fun request(url: String, token: String?): String {
val connection = openConnection(url, readTimeoutMs = 30_000).apply {
token?.let { setRequestProperty("X-Noxely-Token", it) }
}
return try {
when (connection.responseCode) {
401 -> throw IllegalStateException("Jeton refusé par le serveur")
in 200..299 -> connection.inputStream.bufferedReader().readText()
else -> throw IllegalStateException("Le serveur a répondu ${connection.responseCode}")
}
} finally {
connection.disconnect()
}
}
private fun JsonArray?.orEmpty(): JsonArray = this ?: JsonArray(emptyList())
private fun JsonObject.text(key: String): String? =
this[key]?.jsonPrimitive?.content?.takeIf { it.isNotBlank() && it != "null" }
}
@@ -0,0 +1,61 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.sync
import android.content.Context
import androidx.work.Constraints
import androidx.work.CoroutineWorker
import androidx.work.ExistingPeriodicWorkPolicy
import androidx.work.NetworkType
import androidx.work.PeriodicWorkRequestBuilder
import androidx.work.WorkManager
import androidx.work.WorkerParameters
import fr.tuxgyver.noxely.NoxelyApp
import java.util.concurrent.TimeUnit
/**
* Synchronisation planifiée.
*
* Wi-Fi non facturé et batterie non faible : le téléphone ne se réveille que dans les conditions
* où un téléchargement ne coûte rien. C'est le réglage le plus sobre — le serveur, lui, a déjà
* fait tout le travail d'écoute et de collecte.
*/
class SyncWorker(context: Context, params: WorkerParameters) : CoroutineWorker(context, params) {
override suspend fun doWork(): Result {
val container = (applicationContext as NoxelyApp).container
if (!container.serverSettings.config.value.isConfigured) return Result.success()
val outcome = runCatching { container.sync.sync() }.getOrNull()
return if (outcome == null) Result.retry() else Result.success()
}
companion object {
private const val WORK_NAME = "noxely-sync"
fun schedule(context: Context) {
val request = PeriodicWorkRequestBuilder<SyncWorker>(6, TimeUnit.HOURS)
.setConstraints(
Constraints.Builder()
.setRequiredNetworkType(NetworkType.UNMETERED)
.setRequiresBatteryNotLow(true)
.build()
)
.build()
WorkManager.getInstance(context).enqueueUniquePeriodicWork(
WORK_NAME,
ExistingPeriodicWorkPolicy.KEEP,
request,
)
}
}
}
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui
import androidx.activity.compose.BackHandler
@@ -38,37 +50,26 @@ import androidx.navigation.compose.rememberNavController
import fr.tuxgyver.noxely.AppContainer
import fr.tuxgyver.noxely.model.MediaEntry
import fr.tuxgyver.noxely.model.SourceKind
import fr.tuxgyver.noxely.sources.CatalogId
import fr.tuxgyver.noxely.ui.about.AboutScreen
import fr.tuxgyver.noxely.ui.browse.CatalogBrowseScreen
import fr.tuxgyver.noxely.ui.browse.CatalogItemScreen
import fr.tuxgyver.noxely.ui.browse.SourceBrowseScreen
import fr.tuxgyver.noxely.ui.library.LibraryScreen
import fr.tuxgyver.noxely.ui.offline.DownloadsScreen
import fr.tuxgyver.noxely.ui.player.MiniPlayer
import fr.tuxgyver.noxely.ui.radio.RadioScreen
import fr.tuxgyver.noxely.ui.radio.WatchListScreen
import fr.tuxgyver.noxely.ui.server.ServerScreen
import fr.tuxgyver.noxely.ui.playlists.AddToPlaylistSheet
import fr.tuxgyver.noxely.ui.playlists.PlaylistDetailScreen
import fr.tuxgyver.noxely.ui.playlists.PlaylistsScreen
import fr.tuxgyver.noxely.ui.player.NowPlayingScreen
import fr.tuxgyver.noxely.ui.sources.SourcesScreen
import kotlinx.coroutines.launch
private enum class Tab(val route: String, val label: String, val icon: ImageVector) {
LIBRARY("library", "Bibliothèque", Icons.Rounded.LibraryMusic),
OFFLINE("offline", "Hors ligne", Icons.Rounded.CloudDownload),
PLAYLISTS("playlists", "Playlists", Icons.Rounded.PlaylistPlay),
SOURCES("sources", "Sources", Icons.Rounded.Tune),
SERVER("server", "Réglages", Icons.Rounded.Tune),
}
private const val BROWSE_ROUTE = "browse/{source}"
private const val CATALOG_ROUTE = "catalog/{catalog}"
private const val CATALOG_ITEM_ROUTE = "catalog/{catalog}/item"
private const val PLAYLIST_ROUTE = "playlist/{playlist}"
private const val RADIO_ROUTE = "radio"
private const val ABOUT_ROUTE = "about"
private const val WATCHES_ROUTE = "watches"
@Composable
fun NoxelyRoot(container: AppContainer) {
@@ -157,26 +158,30 @@ fun NoxelyRoot(container: AppContainer) {
AboutScreen(onBack = navController::popBackStack, contentPadding = padding)
}
composable(RADIO_ROUTE) {
RadioScreen(
composable(PLAYLIST_ROUTE) { entry ->
PlaylistDetailScreen(
container = container,
playlistId = entry.arguments?.getString("playlist").orEmpty(),
currentMediaId = playerState.mediaId,
onBack = navController::popBackStack,
onMessage = notify,
onOpenWatches = { navController.navigate(WATCHES_ROUTE) },
onPlay = playFrom,
contentPadding = padding,
)
}
composable(WATCHES_ROUTE) {
WatchListScreen(
composable(Tab.SERVER.route) {
ServerScreen(
container = container,
onBack = navController::popBackStack,
onOpenAbout = { navController.navigate(ABOUT_ROUTE) },
onMessage = notify,
contentPadding = padding,
)
}
composable(ABOUT_ROUTE) {
AboutScreen(onBack = navController::popBackStack, contentPadding = padding)
}
composable(PLAYLIST_ROUTE) { entry ->
PlaylistDetailScreen(
container = container,
@@ -188,55 +193,6 @@ fun NoxelyRoot(container: AppContainer) {
)
}
composable(Tab.SOURCES.route) {
SourcesScreen(
container = container,
contentPadding = padding,
onMessage = notify,
onBrowseSource = { navController.navigate("browse/${it.name}") },
onBrowseCatalog = { navController.navigate("catalog/${it.name}") },
onBrowseRadio = { navController.navigate(RADIO_ROUTE) },
onOpenAbout = { navController.navigate(ABOUT_ROUTE) },
)
}
composable(BROWSE_ROUTE) { entry ->
val source = SourceKind.valueOf(entry.arguments?.getString("source") ?: SourceKind.LOCAL.name)
SourceBrowseScreen(
container = container,
source = source,
currentMediaId = playerState.mediaId,
onBack = navController::popBackStack,
onPlay = play,
contentPadding = padding,
)
}
composable(CATALOG_ROUTE) { entry ->
val catalog = CatalogId.valueOf(entry.arguments?.getString("catalog") ?: CatalogId.ARCHIVE.name)
CatalogBrowseScreen(
container = container,
catalogId = catalog,
onBack = navController::popBackStack,
onOpenItem = { item ->
container.openedCatalogItem = item
navController.navigate("catalog/${catalog.name}/item")
},
contentPadding = padding,
)
}
composable(CATALOG_ITEM_ROUTE) { entry ->
val catalog = CatalogId.valueOf(entry.arguments?.getString("catalog") ?: CatalogId.ARCHIVE.name)
CatalogItemScreen(
container = container,
catalogId = catalog,
currentMediaId = playerState.mediaId,
onBack = navController::popBackStack,
onMessage = notify,
contentPadding = padding,
)
}
}
}
@@ -288,4 +244,4 @@ private fun NavHostController.switchTab(route: String) {
launchSingleTop = true
restoreState = true
}
}
}
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.about
import androidx.compose.foundation.Image
@@ -341,6 +353,19 @@ private fun AuthorTab(padding: PaddingValues) {
color = MaterialTheme.colorScheme.primary,
)
Spacer(Modifier.size(18.dp))
Text("Licence", style = MaterialTheme.typography.labelMedium)
Text(
text = "${AppInfo.LICENSE} — logiciel libre, sans aucune garantie.",
style = MaterialTheme.typography.bodySmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
Text(
text = AppInfo.COPYRIGHT,
style = MaterialTheme.typography.bodySmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
Spacer(Modifier.size(18.dp))
Text(
text = AppInfo.AUTHORSHIP,
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.about
import fr.tuxgyver.noxely.BuildConfig
@@ -11,7 +23,7 @@ import fr.tuxgyver.noxely.BuildConfig
object AppInfo {
const val NAME = "Noxely"
const val TAGLINE = "Mettez la musique de côté pendant que vous avez du réseau."
const val TAGLINE = "Le serveur collecte, le téléphone écoute."
val VERSION: String get() = BuildConfig.VERSION_NAME
const val REPOSITORY = "https://git.tuxtech.fr/tuxgyver/Noxely"
@@ -20,31 +32,25 @@ object AppInfo {
const val AUTHORSHIP =
"Application développée avec l'assistance de l'IA, sous la direction et la supervision de Johnny."
/** Aucune licence n'est déclarée dans le dépôt : la pastille le signale plutôt que d'en inventer une. */
const val LICENSE = "Licence à définir"
const val LICENSE_DEFINED = false
const val LICENSE = "GPL v3"
const val LICENSE_DEFINED = true
const val COPYRIGHT = "Copyright © 2026 Johnny (tuxgyver)"
/** Ce que fait l'application, du point de vue de qui l'utilise. */
val FEATURES = listOf(
"Écouter sans réseau" to
"Ce que vous mettez de côté reste lisible dans le métro, en avion ou forfait épuisé. " +
"Audio et vidéo, avec les commandes au casque et sur l'écran verrouillé.",
"Choisir piste par piste" to
"Un album ou un livre affiche ses pistes avec leur durée et leur taille. Vous cochez " +
"ce que vous emportez, et le bouton annonce le poids exact avant de lancer.",
"Essayer avant de garder" to
"Un appui sur une piste la joue en ligne, sans rien mettre en cache. On décide après.",
"Puiser dans des catalogues libres" to
"Internet Archive, Underground (netlabels et Free Music Archive), LibriVox et " +
"Wikimedia Commons, sans compte ni clé, avec filtrage par langue.",
"Écouter et enregistrer la radio" to
"Les stations les plus écoutées, ce qu'elles diffusent à l'instant, et " +
"l'enregistrement d'un direct — qui prend le nom du morceau annoncé.",
"Guetter un morceau" to
"Vous nommez un titre : l'enregistrement se déclenche dès que la station l'annonce, " +
"et s'arrête à la fin du morceau.",
"Ce que le serveur a collecté est sur le téléphone, lisible dans le métro, en avion " +
"ou forfait épuisé. Audio et vidéo, commandes au casque et sur l'écran verrouillé.",
"Se synchroniser sans y penser" to
"Toutes les six heures, en Wi-Fi non facturé et batterie suffisante, l'application " +
"demande au serveur ce qui est neuf et le récupère. Le reste du temps, elle dort.",
"Laisser le travail au serveur" to
"Recherche dans les catalogues, guet des morceaux sur les radios, enregistrement des " +
"directs : tout cela se pilote depuis l'interface web du serveur, pas depuis le mobile.",
"Organiser en playlists" to
"Des listes nommées, alimentées d'un appui long, lues à la suite.",
"Retrouver les pochettes" to
"Les titres sans image en reçoivent une, cherchée sur leur nom.",
"Rester à jour" to
"L'application surveille les publications du dépôt, télécharge la nouvelle version " +
"en Wi-Fi et propose de l'installer.",
@@ -52,20 +58,22 @@ object AppInfo {
/** Chaque promesse est tenue par du code, et dit où. */
val GUARANTEES_INTRO =
"Noxely est un outil personnel : rien n'y transite par un service tiers, et rien ne s'y " +
"télécharge sans un geste de votre part."
"Noxely est un outil personnel : le téléphone ne parle qu'à votre serveur, et rien n'y " +
"transite par un service tiers."
val GUARANTEES = listOf(
"Aucun compte, aucune inscription, aucune télémétrie : le projet n'embarque aucune " +
"bibliothèque d'analyse d'audience.",
"Les seules connexions sortantes sont celles des adresses que vous ajoutez et des " +
"catalogues que vous interrogez.",
"La seule adresse que le mobile contacte est celle de votre serveur, plus le dépôt des " +
"mises à jour. Les catalogues et les radios ne sont joints que par le serveur.",
"Le mobile ne se réveille qu'en Wi-Fi non facturé et batterie suffisante : il ne balaie " +
"plus aucune radio, ne cherche plus et n'enregistre plus.",
"Le cache ne contient que ce que vous avez demandé à garder : rien n'y est écrit pendant " +
"une écoute en ligne, et rien n'en est effacé sans votre geste.",
"Le contenu mis en cache est exclu des sauvegardes dans le nuage et des transferts " +
"d'appareil à appareil.",
"Un téléchargement interrompu par une panne de serveur repart seul, trois fois, en " +
"espaçant les tentatives ; sans réseau, il attend son retour.",
"Une synchronisation partielle ne fait pas avancer le curseur : ce qui a échoué est " +
"repris au passage suivant, jamais perdu.",
"Les catalogues proposés ne présentent que des œuvres libres de droits ou du domaine " +
"public ; les éléments en accès restreint sont écartés avant même d'être affichés.",
"Le jeton qui sert à vérifier les mises à jour est en lecture seule et ne peut rien publier.",
@@ -74,10 +82,11 @@ object AppInfo {
/** Couche → outils. Six lignes suffisent. */
val STACK = listOf(
"Interface" to "Jetpack Compose, Material 3, thèmes clair et sombre",
"Serveur" to "Python, FastAPI, uvicorn, SQLite, service systemd",
"Lecture" to "Media3 / ExoPlayer, MediaSessionService, notification système",
"Hors connexion" to "Cache Media3 non évinçant, WorkManager pour la reprise",
"Hors connexion" to "Fichiers rangés dans MediaStore, lisibles par tout lecteur",
"Bibliothèque" to "MediaStore pour l'appareil, fichiers JSON pour les imports",
"Réseau" to "HttpURLConnection, kotlinx.serialization, flux ICY pour la radio",
"Synchronisation" to "HTTP avec jeton, curseur incrémental, WorkManager",
"Publication" to "APK signé, releases Gitea, mise à jour intégrée",
)
}
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.about
import android.content.Context
@@ -1,233 +0,0 @@
package fr.tuxgyver.noxely.ui.browse
import androidx.compose.foundation.clickable
import androidx.compose.foundation.horizontalScroll
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.PaddingValues
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.foundation.layout.width
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.foundation.text.KeyboardActions
import androidx.compose.foundation.text.KeyboardOptions
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.automirrored.rounded.ArrowBack
import androidx.compose.material.icons.automirrored.rounded.KeyboardArrowRight
import androidx.compose.material.icons.rounded.Search
import androidx.compose.material3.CircularProgressIndicator
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.FilterChip
import androidx.compose.material3.Icon
import androidx.compose.material3.IconButton
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.OutlinedTextField
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.material3.TopAppBar
import androidx.compose.runtime.Composable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.text.input.ImeAction
import androidx.compose.ui.text.style.TextAlign
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import fr.tuxgyver.noxely.AppContainer
import fr.tuxgyver.noxely.model.MediaKind
import fr.tuxgyver.noxely.sources.CatalogId
import fr.tuxgyver.noxely.sources.CatalogItem
import fr.tuxgyver.noxely.ui.components.Artwork
import fr.tuxgyver.noxely.ui.components.formatBytes
import kotlinx.coroutines.launch
/**
* Recherche dans un catalogue libre de droits.
*
* Un résultat n'est pas un fichier mais un album, un livre ou un morceau : l'ouvrir mène à la
* liste de ses pistes, où l'on écoute et où l'on choisit ce qu'on emporte.
*/
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun CatalogBrowseScreen(
container: AppContainer,
catalogId: CatalogId,
onBack: () -> Unit,
onOpenItem: (CatalogItem) -> Unit,
contentPadding: PaddingValues,
) {
val catalog = container.catalogs.getValue(catalogId)
val scope = rememberCoroutineScope()
var query by rememberSaveable { mutableStateOf(catalogId.suggestion) }
var language by rememberSaveable { mutableStateOf<String?>(null) }
var results by remember { mutableStateOf<List<CatalogItem>>(emptyList()) }
var searching by remember { mutableStateOf(false) }
var error by remember { mutableStateOf<String?>(null) }
fun runSearch() {
if (query.isBlank()) return
searching = true
error = null
scope.launch {
catalog.search(query, language).fold(
onSuccess = { results = it; if (it.isEmpty()) error = "Aucun résultat" },
onFailure = { error = it.message ?: "Recherche impossible" },
)
searching = false
}
}
LaunchedEffect(catalogId, language) { runSearch() }
val listPadding = PaddingValues(bottom = contentPadding.calculateBottomPadding())
Column(Modifier.fillMaxSize()) {
TopAppBar(
title = { Text(catalogId.title) },
navigationIcon = {
IconButton(onClick = onBack) {
Icon(Icons.AutoMirrored.Rounded.ArrowBack, contentDescription = "Retour")
}
},
)
Text(
text = catalogId.license,
style = MaterialTheme.typography.labelMedium,
color = MaterialTheme.colorScheme.secondary,
modifier = Modifier.padding(horizontal = 16.dp),
)
OutlinedTextField(
value = query,
onValueChange = { query = it },
placeholder = { Text("Rechercher dans ${catalogId.title}") },
leadingIcon = { Icon(Icons.Rounded.Search, contentDescription = null) },
singleLine = true,
shape = MaterialTheme.shapes.large,
keyboardOptions = KeyboardOptions(imeAction = ImeAction.Search),
keyboardActions = KeyboardActions(onSearch = { runSearch() }),
modifier = Modifier
.fillMaxWidth()
.padding(16.dp),
)
if (catalog.languages.isNotEmpty()) {
Row(
horizontalArrangement = Arrangement.spacedBy(8.dp),
modifier = Modifier
.fillMaxWidth()
.horizontalScroll(rememberScrollState())
.padding(horizontal = 16.dp),
) {
FilterChip(
selected = language == null,
onClick = { language = null },
label = { Text("Toutes langues") },
)
catalog.languages.forEach { option ->
FilterChip(
selected = language == option.code,
onClick = { language = option.code },
label = { Text(option.label) },
)
}
}
Spacer(Modifier.size(8.dp))
}
when {
searching -> Box(Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
CircularProgressIndicator()
}
error != null -> Box(
Modifier
.fillMaxSize()
.padding(32.dp),
contentAlignment = Alignment.Center,
) {
Text(
text = error!!,
style = MaterialTheme.typography.bodyMedium,
color = MaterialTheme.colorScheme.onSurfaceVariant,
textAlign = TextAlign.Center,
)
}
else -> LazyColumn(
contentPadding = listPadding,
verticalArrangement = Arrangement.spacedBy(6.dp),
modifier = Modifier.padding(horizontal = 16.dp),
) {
items(results, key = { it.id }) { item ->
CatalogRow(item = item, onOpen = { onOpenItem(item) })
}
}
}
}
}
@Composable
private fun CatalogRow(item: CatalogItem, onOpen: () -> Unit) {
Surface(
color = MaterialTheme.colorScheme.surface,
shape = MaterialTheme.shapes.medium,
modifier = Modifier
.fillMaxWidth()
.clickable(onClick = onOpen),
) {
Row(
verticalAlignment = Alignment.CenterVertically,
modifier = Modifier.padding(10.dp),
) {
Artwork(
uri = item.artworkUri,
title = item.title,
kind = if (item.hint.contains("Vidéo")) MediaKind.VIDEO else MediaKind.AUDIO,
shape = RoundedCornerShape(14.dp),
modifier = Modifier.size(56.dp),
)
Spacer(Modifier.width(14.dp))
Column(Modifier.weight(1f)) {
Text(
text = item.title,
style = MaterialTheme.typography.titleMedium,
maxLines = 2,
overflow = TextOverflow.Ellipsis,
)
Text(
text = listOfNotNull(
item.subtitle.takeIf { it.isNotBlank() },
item.hint.takeIf { it.isNotBlank() },
item.sizeBytes?.let { "~${formatBytes(it)}" },
).joinToString(" · "),
style = MaterialTheme.typography.bodySmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
maxLines = 1,
overflow = TextOverflow.Ellipsis,
)
}
Icon(
imageVector = Icons.AutoMirrored.Rounded.KeyboardArrowRight,
contentDescription = "Voir les pistes",
tint = MaterialTheme.colorScheme.onSurfaceVariant,
)
}
}
}
@@ -1,255 +0,0 @@
package fr.tuxgyver.noxely.ui.browse
import androidx.compose.foundation.clickable
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.PaddingValues
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.foundation.layout.width
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.automirrored.rounded.ArrowBack
import androidx.compose.material.icons.rounded.GraphicEq
import androidx.compose.material.icons.rounded.PlayCircleOutline
import androidx.compose.material3.Checkbox
import androidx.compose.material3.CircularProgressIndicator
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.Icon
import androidx.compose.material3.IconButton
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton
import androidx.compose.material3.TopAppBar
import androidx.compose.runtime.Composable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.text.style.TextAlign
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import fr.tuxgyver.noxely.AppContainer
import fr.tuxgyver.noxely.model.MediaEntry
import fr.tuxgyver.noxely.sources.CatalogId
import fr.tuxgyver.noxely.ui.components.formatBytes
import fr.tuxgyver.noxely.ui.components.formatDuration
import kotlinx.coroutines.launch
/**
* Les pistes d'un résultat de catalogue.
*
* Un album ou un livre en compte souvent des dizaines : chacune s'écoute d'abord en ligne, et
* n'est mise en cache que si on la coche. La taille de la sélection est annoncée avant l'envoi.
*/
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun CatalogItemScreen(
container: AppContainer,
catalogId: CatalogId,
currentMediaId: String?,
onBack: () -> Unit,
onMessage: (String) -> Unit,
contentPadding: PaddingValues,
) {
val item = container.openedCatalogItem
val scope = rememberCoroutineScope()
var tracks by remember { mutableStateOf<List<MediaEntry>>(emptyList()) }
var selection by remember { mutableStateOf(emptySet<String>()) }
var loading by remember { mutableStateOf(true) }
var error by remember { mutableStateOf<String?>(null) }
var adding by remember { mutableStateOf(false) }
LaunchedEffect(item?.id) {
val opened = item ?: run {
onBack()
return@LaunchedEffect
}
loading = true
container.catalogs.getValue(catalogId).tracks(opened).fold(
onSuccess = { tracks = it; error = if (it.isEmpty()) "Aucune piste lisible" else null },
onFailure = { error = it.message ?: "Contenu illisible" },
)
loading = false
}
val selectedSize = remember(selection, tracks) {
tracks.filter { it.id in selection }.sumOf { it.sizeBytes ?: 0L }
}
val listPadding = PaddingValues(bottom = contentPadding.calculateBottomPadding())
Box(Modifier.fillMaxSize()) {
Column(Modifier.fillMaxSize()) {
TopAppBar(
title = {
Text(
text = item?.title ?: "Pistes",
maxLines = 1,
overflow = TextOverflow.Ellipsis,
)
},
navigationIcon = {
IconButton(onClick = onBack) {
Icon(Icons.AutoMirrored.Rounded.ArrowBack, contentDescription = "Retour")
}
},
actions = {
if (tracks.isNotEmpty()) {
TextButton(onClick = {
selection = if (selection.size == tracks.size) emptySet()
else tracks.mapTo(mutableSetOf()) { it.id }
}) {
Text(if (selection.size == tracks.size) "Aucune" else "Toutes")
}
}
},
)
if (tracks.isNotEmpty()) {
val total = tracks.sumOf { it.sizeBytes ?: 0L }
Text(
text = buildString {
append("${tracks.size} piste(s)")
if (total > 0) append(" · ${formatBytes(total)} au total")
append(" · appuyez pour écouter en ligne")
},
style = MaterialTheme.typography.labelMedium,
color = MaterialTheme.colorScheme.onSurfaceVariant,
modifier = Modifier.padding(horizontal = 16.dp, vertical = 4.dp),
)
}
when {
loading -> Box(Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
CircularProgressIndicator()
}
error != null -> Box(
Modifier
.fillMaxSize()
.padding(32.dp),
contentAlignment = Alignment.Center,
) {
Text(
text = error!!,
style = MaterialTheme.typography.bodyMedium,
color = MaterialTheme.colorScheme.onSurfaceVariant,
textAlign = TextAlign.Center,
)
}
else -> LazyColumn(
contentPadding = listPadding,
verticalArrangement = Arrangement.spacedBy(4.dp),
modifier = Modifier.padding(horizontal = 16.dp),
) {
items(tracks, key = { it.id }) { track ->
TrackRow(
track = track,
playing = track.id == currentMediaId,
selected = track.id in selection,
onPreview = {
// Un aperçu ne rejoint pas la bibliothèque : on le confie au
// registre transitoire pour que la lecture sache le résoudre.
container.library.preview(tracks)
container.player.play(tracks, tracks.indexOf(track))
},
onToggle = {
selection = if (track.id in selection) selection - track.id
else selection + track.id
},
)
}
item { Spacer(Modifier.size(88.dp)) }
}
}
}
SelectionBar(
count = selection.size,
actionLabel = if (selectedSize > 0) "Garder ${formatBytes(selectedSize)}" else "Garder",
busy = adding,
onClear = { selection = emptySet() },
onConfirm = {
adding = true
scope.launch {
val chosen = tracks.filter { it.id in selection }
val added = container.imported.add(chosen)
chosen.forEach(container.downloads::download)
adding = false
selection = emptySet()
onMessage(
if (added == 0) "Ces pistes sont déjà dans la bibliothèque"
else "$added piste(s) ajoutées, téléchargement lancé"
)
}
},
modifier = Modifier
.align(Alignment.BottomCenter)
.padding(contentPadding),
)
}
}
@Composable
private fun TrackRow(
track: MediaEntry,
playing: Boolean,
selected: Boolean,
onPreview: () -> Unit,
onToggle: () -> Unit,
) {
Surface(
color = when {
playing -> MaterialTheme.colorScheme.primaryContainer
selected -> MaterialTheme.colorScheme.secondaryContainer
else -> MaterialTheme.colorScheme.surface
},
shape = MaterialTheme.shapes.small,
modifier = Modifier
.fillMaxWidth()
.clickable(onClick = onPreview),
) {
Row(
verticalAlignment = Alignment.CenterVertically,
modifier = Modifier.padding(horizontal = 8.dp, vertical = 6.dp),
) {
Icon(
imageVector = if (playing) Icons.Rounded.GraphicEq else Icons.Rounded.PlayCircleOutline,
contentDescription = if (playing) "En lecture" else "Écouter en ligne",
tint = if (playing) MaterialTheme.colorScheme.primary
else MaterialTheme.colorScheme.onSurfaceVariant,
)
Spacer(Modifier.width(12.dp))
Column(Modifier.weight(1f)) {
Text(
text = track.title,
style = MaterialTheme.typography.bodyLarge,
maxLines = 1,
overflow = TextOverflow.Ellipsis,
)
Text(
text = listOfNotNull(
track.durationMs.takeIf { it > 0 }?.let(::formatDuration),
track.sizeBytes?.takeIf { it > 0 }?.let(::formatBytes),
).joinToString(" · ").ifBlank { "Taille inconnue" },
style = MaterialTheme.typography.labelSmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
}
Checkbox(checked = selected, onCheckedChange = { onToggle() })
}
}
}
@@ -1,78 +0,0 @@
package fr.tuxgyver.noxely.ui.browse
import androidx.compose.animation.AnimatedVisibility
import androidx.compose.animation.slideInVertically
import androidx.compose.animation.slideOutVertically
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.rounded.Download
import androidx.compose.material3.Button
import androidx.compose.material3.CircularProgressIndicator
import androidx.compose.material3.Icon
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton
import androidx.compose.runtime.Composable
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
/** Barre d'action des écrans de sélection : combien d'éléments, et que faire de la sélection. */
@Composable
fun SelectionBar(
count: Int,
actionLabel: String,
busy: Boolean,
onClear: () -> Unit,
onConfirm: () -> Unit,
modifier: Modifier = Modifier,
) {
AnimatedVisibility(
visible = count > 0,
enter = slideInVertically { it },
exit = slideOutVertically { it },
modifier = modifier,
) {
Surface(
color = MaterialTheme.colorScheme.secondaryContainer,
shape = MaterialTheme.shapes.large,
tonalElevation = 3.dp,
shadowElevation = 8.dp,
modifier = Modifier
.fillMaxWidth()
.padding(horizontal = 12.dp, vertical = 8.dp),
) {
Row(
verticalAlignment = Alignment.CenterVertically,
horizontalArrangement = Arrangement.spacedBy(8.dp),
modifier = Modifier.padding(horizontal = 16.dp, vertical = 10.dp),
) {
Text(
text = "$count sélectionné(s)",
style = MaterialTheme.typography.titleSmall,
modifier = Modifier.weight(1f),
)
TextButton(onClick = onClear, enabled = !busy) { Text("Effacer") }
Button(onClick = onConfirm, enabled = !busy) {
if (busy) {
CircularProgressIndicator(
strokeWidth = 2.dp,
color = MaterialTheme.colorScheme.onPrimary,
modifier = Modifier.size(18.dp),
)
} else {
Icon(Icons.Rounded.Download, contentDescription = null, modifier = Modifier.size(18.dp))
}
Spacer(Modifier.size(8.dp))
Text(actionLabel)
}
}
}
}
}
@@ -1,178 +0,0 @@
package fr.tuxgyver.noxely.ui.browse
import androidx.compose.foundation.horizontalScroll
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.PaddingValues
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
import androidx.compose.foundation.rememberScrollState
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.automirrored.rounded.ArrowBack
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.FilterChip
import androidx.compose.material3.Icon
import androidx.compose.material3.IconButton
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton
import androidx.compose.material3.TopAppBar
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.text.style.TextAlign
import androidx.compose.ui.unit.dp
import androidx.lifecycle.compose.collectAsStateWithLifecycle
import fr.tuxgyver.noxely.AppContainer
import fr.tuxgyver.noxely.model.MediaEntry
import fr.tuxgyver.noxely.model.SourceKind
import fr.tuxgyver.noxely.ui.components.MediaRow
/**
* Parcours d'une source déjà présente dans la bibliothèque : on y choisit, un par un ou en lot,
* ce qui doit être gardé sur l'appareil.
*/
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun SourceBrowseScreen(
container: AppContainer,
source: SourceKind,
currentMediaId: String?,
onBack: () -> Unit,
onPlay: (List<MediaEntry>, Int) -> Unit,
contentPadding: PaddingValues,
) {
val entries by container.library.entries.collectAsStateWithLifecycle()
val offlineStates by container.downloads.states.collectAsStateWithLifecycle()
val ofSource = remember(entries, source) { entries.filter { it.source == source } }
val collections = remember(ofSource) { ofSource.map { it.subtitle }.distinct().sorted() }
var collection by rememberSaveable { mutableStateOf<String?>(null) }
var selection by remember { mutableStateOf(emptySet<String>()) }
val visible = remember(ofSource, collection) {
if (collection == null) ofSource else ofSource.filter { it.subtitle == collection }
}
val selectable = remember(visible, offlineStates) {
visible.filter { it.isRemote && offlineStates[it.id]?.isComplete != true }
}
// La barre de titre occupe déjà l'espace haut du Scaffold : la liste ne reprend que le bas.
val listPadding = PaddingValues(bottom = contentPadding.calculateBottomPadding())
Box(Modifier.fillMaxSize()) {
Column(Modifier.fillMaxSize()) {
TopAppBar(
title = { Text(source.label) },
navigationIcon = {
IconButton(onClick = onBack) {
Icon(Icons.AutoMirrored.Rounded.ArrowBack, contentDescription = "Retour")
}
},
actions = {
if (selectable.isNotEmpty()) {
TextButton(onClick = {
selection = if (selection.size == selectable.size) emptySet()
else selectable.mapTo(mutableSetOf()) { it.id }
}) {
Text(if (selection.size == selectable.size) "Aucun" else "Tout")
}
}
},
)
if (collections.size > 1) {
Row(
horizontalArrangement = Arrangement.spacedBy(8.dp),
modifier = Modifier
.fillMaxWidth()
.horizontalScroll(rememberScrollState())
.padding(horizontal = 16.dp, vertical = 4.dp),
) {
FilterChip(
selected = collection == null,
onClick = { collection = null },
label = { Text("Tout") },
)
collections.forEach { name ->
FilterChip(
selected = collection == name,
onClick = { collection = name },
label = { Text(name) },
)
}
}
}
if (visible.isEmpty()) {
Box(
contentAlignment = Alignment.Center,
modifier = Modifier
.fillMaxSize()
.padding(32.dp),
) {
Text(
text = "Aucun contenu pour cette source. Ajoutez-en depuis l'écran Sources.",
style = MaterialTheme.typography.bodyMedium,
color = MaterialTheme.colorScheme.onSurfaceVariant,
textAlign = TextAlign.Center,
)
}
} else {
LazyColumn(
contentPadding = listPadding,
verticalArrangement = Arrangement.spacedBy(6.dp),
modifier = Modifier.padding(horizontal = 16.dp),
) {
items(visible, key = { it.id }) { entry ->
val canSelect = entry.isRemote && offlineStates[entry.id]?.isComplete != true
MediaRow(
entry = entry,
offline = offlineStates[entry.id],
isCurrent = entry.id == currentMediaId,
selected = if (canSelect) entry.id in selection else null,
onClick = {
if (canSelect) {
selection = if (entry.id in selection) selection - entry.id
else selection + entry.id
} else {
onPlay(visible, visible.indexOf(entry))
}
},
onDownload = { container.downloads.download(entry) },
onRemoveOffline = { container.downloads.remove(entry.id) },
)
}
item { Spacer(Modifier.size(88.dp)) }
}
}
}
SelectionBar(
count = selection.size,
actionLabel = "Télécharger",
busy = false,
onClear = { selection = emptySet() },
onConfirm = {
visible.filter { it.id in selection }.forEach(container.downloads::download)
selection = emptySet()
},
modifier = Modifier
.align(Alignment.BottomCenter)
.padding(contentPadding),
)
}
}
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.components
import android.graphics.Bitmap
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.components
import java.util.Locale
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.components
import androidx.compose.animation.animateColorAsState
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.library
import androidx.activity.compose.rememberLauncherForActivityResult
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.offline
import androidx.compose.foundation.layout.Arrangement
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.player
import androidx.compose.foundation.basicMarquee
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.player
import androidx.annotation.OptIn
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.playlists
import androidx.compose.foundation.clickable
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.playlists
import androidx.compose.foundation.layout.Arrangement
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.playlists
import androidx.compose.foundation.clickable
@@ -1,446 +0,0 @@
package fr.tuxgyver.noxely.ui.radio
import androidx.compose.foundation.clickable
import androidx.compose.foundation.horizontalScroll
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.PaddingValues
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.foundation.layout.width
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.foundation.text.KeyboardActions
import androidx.compose.foundation.text.KeyboardOptions
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.automirrored.rounded.ArrowBack
import androidx.compose.material.icons.rounded.FiberManualRecord
import androidx.compose.material.icons.rounded.Alarm
import androidx.compose.material.icons.rounded.GraphicEq
import androidx.compose.material.icons.rounded.PlayCircleOutline
import androidx.compose.material.icons.rounded.Radar
import androidx.compose.material.icons.rounded.Search
import androidx.compose.material.icons.rounded.Stop
import androidx.compose.material3.Button
import androidx.compose.material3.AlertDialog
import androidx.compose.material3.CircularProgressIndicator
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.FilterChip
import androidx.compose.material3.Icon
import androidx.compose.material3.IconButton
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.OutlinedTextField
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton
import androidx.compose.material3.TopAppBar
import androidx.compose.runtime.Composable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.platform.LocalContext
import androidx.compose.ui.text.input.ImeAction
import androidx.compose.ui.text.style.TextAlign
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import androidx.lifecycle.compose.collectAsStateWithLifecycle
import fr.tuxgyver.noxely.AppContainer
import fr.tuxgyver.noxely.model.MediaEntry
import fr.tuxgyver.noxely.model.MediaKind
import fr.tuxgyver.noxely.model.SourceKind
import fr.tuxgyver.noxely.radio.RADIO_GENRES
import fr.tuxgyver.noxely.radio.RadioStation
import fr.tuxgyver.noxely.radio.Recorder
import fr.tuxgyver.noxely.radio.RecordingService
import fr.tuxgyver.noxely.ui.components.Artwork
import fr.tuxgyver.noxely.ui.components.formatBytes
import fr.tuxgyver.noxely.ui.components.formatDuration
import kotlinx.coroutines.delay
import kotlinx.coroutines.async
import kotlinx.coroutines.awaitAll
import kotlinx.coroutines.launch
/**
* Les stations les plus écoutées, à écouter en direct ou à enregistrer.
*
* L'enregistrement produit un fichier local qui rejoint la bibliothèque : il n'a donc rien à
* télécharger ensuite, il est déjà hors connexion.
*/
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun RadioScreen(
container: AppContainer,
currentMediaId: String?,
onBack: () -> Unit,
onMessage: (String) -> Unit,
onOpenWatches: () -> Unit,
contentPadding: PaddingValues,
) {
val context = LocalContext.current
val scope = rememberCoroutineScope()
val status by Recorder.status.collectAsStateWithLifecycle()
var query by rememberSaveable { mutableStateOf("") }
var genre by rememberSaveable { mutableStateOf<String?>(null) }
var stations by remember { mutableStateOf<List<RadioStation>>(emptyList()) }
var loading by remember { mutableStateOf(true) }
var error by remember { mutableStateOf<String?>(null) }
var nowPlaying by remember { mutableStateOf(emptyMap<String, String>()) }
var scheduleFor by remember { mutableStateOf<RadioStation?>(null) }
fun load() {
loading = true
error = null
scope.launch {
val outcome = if (query.isBlank()) container.radio.popular(genre)
else container.radio.search(query)
outcome.fold(
onSuccess = { stations = it; if (it.isEmpty()) error = "Aucune station" },
onFailure = { error = it.message ?: "Annuaire indisponible" },
)
loading = false
}
}
LaunchedEffect(genre) { load() }
// Aucun annuaire n'expose le morceau en cours : il faut ouvrir chaque flux. On s'en tient
// donc aux premières stations affichées, quatre à la fois, et le résultat est conservé.
LaunchedEffect(stations) {
nowPlaying = emptyMap()
stations.take(PROBED_STATIONS).chunked(4).forEach { group ->
val found = group.map { station ->
async { station.id to container.radio.nowPlaying(station.streamUrl) }
}.awaitAll()
nowPlaying = nowPlaying + found.mapNotNull { (id, title) ->
title?.let { id to it }
}
}
}
val listPadding = PaddingValues(bottom = contentPadding.calculateBottomPadding())
Column(Modifier.fillMaxSize()) {
TopAppBar(
title = { Text("Radio") },
actions = {
IconButton(onClick = onOpenWatches) {
Icon(Icons.Rounded.Radar, contentDescription = "Morceaux guettés")
}
},
navigationIcon = {
IconButton(onClick = onBack) {
Icon(Icons.AutoMirrored.Rounded.ArrowBack, contentDescription = "Retour")
}
},
)
if (status.isRecording) {
// La progression n'est publiée que tous les 256 Ko : le chronomètre se rafraîchit
// donc de lui-même, sinon il semblerait figé entre deux paliers.
var tick by remember { mutableStateOf(0L) }
LaunchedEffect(status.startedAt) {
while (true) {
tick = System.currentTimeMillis()
delay(1_000)
}
}
RecordingBanner(
station = status.station!!,
title = status.currentTitle,
waitingFor = status.waitingFor,
elapsedMs = (tick - status.startedAt).coerceAtLeast(0L),
bytes = status.bytes,
onStop = {
RecordingService.stop(context)
onMessage("Enregistrement versé dans la bibliothèque")
},
)
}
OutlinedTextField(
value = query,
onValueChange = { query = it },
placeholder = { Text("Rechercher une station") },
leadingIcon = { Icon(Icons.Rounded.Search, contentDescription = null) },
singleLine = true,
shape = MaterialTheme.shapes.large,
keyboardOptions = KeyboardOptions(imeAction = ImeAction.Search),
keyboardActions = KeyboardActions(onSearch = { load() }),
modifier = Modifier
.fillMaxWidth()
.padding(16.dp),
)
Row(
horizontalArrangement = Arrangement.spacedBy(8.dp),
modifier = Modifier
.fillMaxWidth()
.horizontalScroll(rememberScrollState())
.padding(horizontal = 16.dp),
) {
FilterChip(
selected = genre == null,
onClick = { genre = null; query = "" },
label = { Text("Les plus écoutées") },
)
RADIO_GENRES.forEach { option ->
FilterChip(
selected = genre == option,
onClick = { genre = option; query = "" },
label = { Text(option.replaceFirstChar(Char::uppercase)) },
)
}
}
Spacer(Modifier.size(8.dp))
when {
loading -> Box(Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
CircularProgressIndicator()
}
error != null -> Box(
Modifier
.fillMaxSize()
.padding(32.dp),
contentAlignment = Alignment.Center,
) {
Text(
text = error!!,
style = MaterialTheme.typography.bodyMedium,
color = MaterialTheme.colorScheme.onSurfaceVariant,
textAlign = TextAlign.Center,
)
}
else -> LazyColumn(
contentPadding = listPadding,
verticalArrangement = Arrangement.spacedBy(6.dp),
modifier = Modifier.padding(horizontal = 16.dp),
) {
items(stations, key = { it.id }) { station ->
StationRow(
station = station,
nowPlaying = nowPlaying[station.id],
playing = station.asEntry().id == currentMediaId,
recording = status.station?.id == station.id,
onSchedule = { scheduleFor = station },
onListen = {
val entry = station.asEntry()
container.library.preview(listOf(entry))
container.player.play(listOf(entry), 0)
},
onRecord = {
if (status.isRecording) {
onMessage("Un enregistrement est déjà en cours")
} else {
RecordingService.start(context, station)
onMessage("Enregistrement de ${station.name} démarré")
}
},
)
}
item { Spacer(Modifier.size(24.dp)) }
}
}
}
scheduleFor?.let { station ->
ScheduleDialog(
station = station,
onDismiss = { scheduleFor = null },
onConfirm = { wanted ->
RecordingService.start(context, station, whenTitleContains = wanted)
onMessage("Noxely guette « $wanted » sur ${station.name}")
scheduleFor = null
},
)
}
}
/** Au-delà, le nombre de connexions simultanées ne se justifierait plus. */
private const val PROBED_STATIONS = 12
/** Une station écoutée en direct est un média éphémère : pas de durée, pas de mise en cache. */
private fun RadioStation.asEntry() = MediaEntry(
id = "radio:$id",
source = SourceKind.URL,
kind = MediaKind.AUDIO,
title = name,
subtitle = subtitle.ifBlank { "Radio en direct" },
uri = streamUrl,
artworkUri = faviconUrl,
)
/** Programme un enregistrement : il démarrera dès que la station annoncera ce titre. */
@Composable
private fun ScheduleDialog(
station: RadioStation,
onDismiss: () -> Unit,
onConfirm: (String) -> Unit,
) {
var wanted by remember { mutableStateOf("") }
AlertDialog(
onDismissRequest = onDismiss,
title = { Text("Guetter un titre") },
text = {
Column {
Text(
text = "Noxely écoutera ${station.name} et déclenchera l'enregistrement dès " +
"qu'un titre contenant ce texte sera annoncé, puis s'arrêtera à la fin du morceau.",
style = MaterialTheme.typography.bodyMedium,
)
Spacer(Modifier.size(12.dp))
OutlinedTextField(
value = wanted,
onValueChange = { wanted = it },
placeholder = { Text("Titre ou artiste") },
singleLine = true,
)
}
},
confirmButton = {
TextButton(enabled = wanted.isNotBlank(), onClick = { onConfirm(wanted.trim()) }) {
Text("Guetter")
}
},
dismissButton = { TextButton(onClick = onDismiss) { Text("Annuler") } },
)
}
@Composable
private fun RecordingBanner(
station: RadioStation,
title: String?,
waitingFor: String?,
elapsedMs: Long,
bytes: Long,
onStop: () -> Unit,
) {
Surface(
color = MaterialTheme.colorScheme.errorContainer,
shape = MaterialTheme.shapes.medium,
modifier = Modifier
.fillMaxWidth()
.padding(horizontal = 16.dp, vertical = 4.dp),
) {
Row(
verticalAlignment = Alignment.CenterVertically,
modifier = Modifier.padding(12.dp),
) {
Icon(
Icons.Rounded.FiberManualRecord,
contentDescription = null,
tint = Color(0xFFD32F2F),
)
Spacer(Modifier.width(12.dp))
Column(Modifier.weight(1f)) {
Text(
text = waitingFor?.let { "En attente de « $it »" } ?: title ?: station.name,
style = MaterialTheme.typography.titleSmall,
maxLines = 1,
overflow = TextOverflow.Ellipsis,
)
Text(
text = listOfNotNull(
title?.let { station.name },
formatDuration(elapsedMs),
formatBytes(bytes),
).joinToString(" · "),
style = MaterialTheme.typography.labelMedium,
maxLines = 1,
overflow = TextOverflow.Ellipsis,
)
}
Button(onClick = onStop) {
Icon(Icons.Rounded.Stop, contentDescription = null, modifier = Modifier.size(18.dp))
Spacer(Modifier.size(6.dp))
Text("Arrêter")
}
}
}
}
@Composable
private fun StationRow(
station: RadioStation,
nowPlaying: String?,
playing: Boolean,
recording: Boolean,
onListen: () -> Unit,
onRecord: () -> Unit,
onSchedule: () -> Unit,
) {
Surface(
color = if (playing) MaterialTheme.colorScheme.primaryContainer
else MaterialTheme.colorScheme.surface,
shape = MaterialTheme.shapes.medium,
modifier = Modifier
.fillMaxWidth()
.clickable(onClick = onListen),
) {
Row(
verticalAlignment = Alignment.CenterVertically,
modifier = Modifier.padding(10.dp),
) {
Artwork(
uri = station.faviconUrl,
title = station.name,
kind = MediaKind.AUDIO,
shape = RoundedCornerShape(12.dp),
modifier = Modifier.size(48.dp),
)
Spacer(Modifier.width(14.dp))
Column(Modifier.weight(1f)) {
Text(
text = station.name,
style = MaterialTheme.typography.titleMedium,
maxLines = 1,
overflow = TextOverflow.Ellipsis,
)
Text(
text = nowPlaying ?: station.subtitle,
style = MaterialTheme.typography.bodySmall,
color = if (nowPlaying != null) MaterialTheme.colorScheme.secondary
else MaterialTheme.colorScheme.onSurfaceVariant,
maxLines = 1,
overflow = TextOverflow.Ellipsis,
)
}
Icon(
imageVector = if (playing) Icons.Rounded.GraphicEq else Icons.Rounded.PlayCircleOutline,
contentDescription = if (playing) "En écoute" else "Écouter en direct",
tint = if (playing) MaterialTheme.colorScheme.primary
else MaterialTheme.colorScheme.onSurfaceVariant,
)
IconButton(onClick = onSchedule) {
Icon(
Icons.Rounded.Alarm,
contentDescription = "Enregistrer quand un titre passe",
tint = MaterialTheme.colorScheme.onSurfaceVariant,
)
}
IconButton(onClick = onRecord) {
Icon(
Icons.Rounded.FiberManualRecord,
contentDescription = "Enregistrer cette station",
tint = if (recording) Color(0xFFD32F2F) else MaterialTheme.colorScheme.onSurfaceVariant,
)
}
}
}
}
@@ -1,271 +0,0 @@
package fr.tuxgyver.noxely.ui.radio
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Box
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.PaddingValues
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.foundation.layout.width
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.automirrored.rounded.ArrowBack
import androidx.compose.material.icons.rounded.Add
import androidx.compose.material.icons.rounded.CheckCircle
import androidx.compose.material.icons.rounded.DeleteOutline
import androidx.compose.material.icons.rounded.HourglassEmpty
import androidx.compose.material.icons.rounded.Radar
import androidx.compose.material3.Button
import androidx.compose.material3.CircularProgressIndicator
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.Icon
import androidx.compose.material3.IconButton
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.OutlinedTextField
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.material3.TopAppBar
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.platform.LocalContext
import androidx.compose.ui.text.style.TextAlign
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import androidx.lifecycle.compose.collectAsStateWithLifecycle
import fr.tuxgyver.noxely.AppContainer
import fr.tuxgyver.noxely.radio.Watch
import kotlinx.coroutines.launch
import java.text.SimpleDateFormat
import java.util.Date
import java.util.Locale
/**
* Les morceaux guettés sur l'ensemble des stations : ceux qu'on attend, et ceux qui sont passés.
*
* Le balayage automatique tourne au quart d'heure — le minimum qu'autorise le système. Un morceau
* durant trois à quatre minutes, il en manque forcément : le bouton « Balayer » sert à regarder
* tout de suite, quand on sait qu'un titre tourne.
*/
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun WatchListScreen(
container: AppContainer,
onBack: () -> Unit,
onMessage: (String) -> Unit,
contentPadding: PaddingValues,
) {
val context = LocalContext.current
val scope = rememberCoroutineScope()
val watches by container.watches.watches.collectAsStateWithLifecycle()
var query by remember { mutableStateOf("") }
var scanning by remember { mutableStateOf(false) }
val watching by fr.tuxgyver.noxely.radio.WatchService.isRunning.collectAsStateWithLifecycle()
val pending = watches.filterNot { it.isFound }
val found = watches.filter { it.isFound }
val listPadding = PaddingValues(bottom = contentPadding.calculateBottomPadding())
Column(Modifier.fillMaxSize()) {
TopAppBar(
title = { Text("Guets") },
navigationIcon = {
IconButton(onClick = onBack) {
Icon(Icons.AutoMirrored.Rounded.ArrowBack, contentDescription = "Retour")
}
},
actions = {
if (scanning) {
CircularProgressIndicator(
strokeWidth = 2.dp,
modifier = Modifier.size(22.dp).padding(end = 8.dp),
)
} else if (pending.isNotEmpty()) {
IconButton(onClick = {
scanning = true
scope.launch {
val outcome = runCatching { container.watchScanner.scan(context) }.getOrNull()
scanning = false
onMessage(
when {
outcome == null -> "Balayage impossible"
outcome.matched != null ->
"Trouvé sur ${outcome.matchedOn} : ${outcome.matched}"
else ->
"${outcome.stationsProbed} stations écoutées, ${outcome.titlesRead} titres lus, rien de guetté"
}
)
}
}) {
Icon(Icons.Rounded.Radar, contentDescription = "Balayer maintenant")
}
}
},
)
if (pending.isNotEmpty()) {
Surface(
color = if (watching) MaterialTheme.colorScheme.secondaryContainer
else MaterialTheme.colorScheme.surfaceVariant,
shape = MaterialTheme.shapes.medium,
modifier = Modifier.fillMaxWidth().padding(horizontal = 16.dp),
) {
Row(verticalAlignment = Alignment.CenterVertically, modifier = Modifier.padding(14.dp)) {
Column(Modifier.weight(1f)) {
Text(
text = if (watching) "Veille active" else "Veille en arrière-plan",
style = MaterialTheme.typography.titleSmall,
)
Text(
text = if (watching) {
"Les stations sont balayées toutes les 3 minutes, écran éteint compris."
} else {
"Sans elle, le balayage n'a lieu qu'au quart d'heure : un morceau de " +
"trois minutes passe souvent entre deux."
},
style = MaterialTheme.typography.bodySmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
}
Spacer(Modifier.width(10.dp))
Button(onClick = {
if (watching) fr.tuxgyver.noxely.radio.WatchService.stop(context)
else fr.tuxgyver.noxely.radio.WatchService.start(context)
}) {
Text(if (watching) "Arrêter" else "Activer")
}
}
}
Spacer(Modifier.size(8.dp))
}
Row(
verticalAlignment = Alignment.CenterVertically,
modifier = Modifier.fillMaxWidth().padding(horizontal = 16.dp, vertical = 8.dp),
) {
OutlinedTextField(
value = query,
onValueChange = { query = it },
placeholder = { Text("Titre ou artiste à guetter") },
singleLine = true,
shape = MaterialTheme.shapes.medium,
modifier = Modifier.weight(1f),
)
Spacer(Modifier.width(8.dp))
Button(
enabled = query.isNotBlank(),
onClick = {
// La valeur est capturée avant d'être effacée : la coroutine lirait sinon
// un champ déjà vidé, et n'enregistrerait rien.
val wanted = query.trim()
scope.launch { container.watches.add(wanted) }
onMessage("« $wanted » est guetté sur toutes les stations")
query = ""
},
) {
Icon(Icons.Rounded.Add, contentDescription = null, modifier = Modifier.size(18.dp))
}
}
LazyColumn(
contentPadding = listPadding,
verticalArrangement = Arrangement.spacedBy(6.dp),
modifier = Modifier.padding(horizontal = 16.dp),
) {
if (watches.isEmpty()) {
item {
Box(
Modifier.fillMaxWidth().padding(vertical = 48.dp),
contentAlignment = Alignment.Center,
) {
Text(
text = "Nommez un morceau : Noxely écoutera les stations les plus suivies " +
"et l'enregistrera dès qu'il passera.",
style = MaterialTheme.typography.bodyMedium,
color = MaterialTheme.colorScheme.onSurfaceVariant,
textAlign = TextAlign.Center,
)
}
}
}
if (pending.isNotEmpty()) {
item { SectionTitle("En attente (${pending.size})") }
items(pending, key = { it.id }) { watch ->
WatchRow(watch) { scope.launch { container.watches.remove(watch.id) } }
}
}
if (found.isNotEmpty()) {
item { SectionTitle("Trouvés (${found.size})") }
items(found, key = { it.id }) { watch ->
WatchRow(watch) { scope.launch { container.watches.remove(watch.id) } }
}
}
item { Spacer(Modifier.size(24.dp)) }
}
}
}
@Composable
private fun SectionTitle(text: String) {
Spacer(Modifier.size(10.dp))
Text(text, style = MaterialTheme.typography.titleSmall)
}
@Composable
private fun WatchRow(watch: Watch, onRemove: () -> Unit) {
Surface(
color = if (watch.isFound) MaterialTheme.colorScheme.secondaryContainer
else MaterialTheme.colorScheme.surface,
shape = MaterialTheme.shapes.medium,
tonalElevation = 1.dp,
modifier = Modifier.fillMaxWidth(),
) {
Row(verticalAlignment = Alignment.CenterVertically, modifier = Modifier.padding(12.dp)) {
Icon(
imageVector = if (watch.isFound) Icons.Rounded.CheckCircle else Icons.Rounded.HourglassEmpty,
contentDescription = null,
tint = if (watch.isFound) MaterialTheme.colorScheme.secondary
else MaterialTheme.colorScheme.onSurfaceVariant,
)
Spacer(Modifier.width(12.dp))
Column(Modifier.weight(1f)) {
Text(
text = watch.query,
style = MaterialTheme.typography.titleSmall,
maxLines = 1,
overflow = TextOverflow.Ellipsis,
)
Text(
text = if (watch.isFound) {
"Capté sur ${watch.foundOn} · ${watch.foundTitle?.take(48).orEmpty()}"
} else {
val last = watch.lastScanAt
?.let { SimpleDateFormat("HH:mm", Locale.FRANCE).format(Date(it)) }
"${watch.scans} balayage(s)" + (last?.let { ", dernier à $it" } ?: ", pas encore balayé")
},
style = MaterialTheme.typography.bodySmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
maxLines = 2,
overflow = TextOverflow.Ellipsis,
)
}
IconButton(onClick = onRemove) {
Icon(Icons.Rounded.DeleteOutline, contentDescription = "Retirer ce guet")
}
}
}
}
@@ -0,0 +1,285 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.server
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.PaddingValues
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.foundation.layout.width
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.rounded.CloudSync
import androidx.compose.material.icons.rounded.Info
import androidx.compose.material3.Button
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.CircularProgressIndicator
import androidx.compose.material3.Icon
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.OutlinedTextField
import androidx.compose.material3.ScrollableTabRow
import androidx.compose.material3.Surface
import androidx.compose.material3.Tab
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton
import androidx.compose.runtime.Composable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.text.input.PasswordVisualTransformation
import androidx.compose.ui.unit.dp
import androidx.lifecycle.compose.collectAsStateWithLifecycle
import fr.tuxgyver.noxely.AppContainer
import fr.tuxgyver.noxely.BuildConfig
import fr.tuxgyver.noxely.ui.sources.UpdateCard
import kotlinx.coroutines.launch
import java.text.SimpleDateFormat
import java.util.Date
import java.util.Locale
private val SETTINGS_TABS = listOf("🔌 Connexion", "🔄 Synchronisation", "📱 Application")
/**
* Réglages, rangés par catégorie.
*
* L'écran mêlait la connexion au serveur, l'état des synchronisations et les affaires de
* l'application elle-même. Trois sujets, trois onglets : on ne défile plus pour trouver.
*/
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun ServerScreen(
container: AppContainer,
onOpenAbout: () -> Unit,
onMessage: (String) -> Unit,
contentPadding: PaddingValues,
) {
var tab by rememberSaveable { mutableIntStateOf(0) }
val config by container.serverSettings.config.collectAsStateWithLifecycle()
val scope = rememberCoroutineScope()
var url by remember { mutableStateOf("") }
var token by remember { mutableStateOf("") }
var busy by remember { mutableStateOf(false) }
var probe by remember { mutableStateOf<String?>(null) }
LaunchedEffect(config.baseUrl, config.token) {
if (url.isBlank()) url = config.baseUrl
if (token.isBlank()) token = config.token
}
Column(Modifier.fillMaxSize()) {
Column(Modifier.padding(horizontal = 16.dp).padding(top = 12.dp, bottom = 8.dp)) {
Text("Réglages", style = MaterialTheme.typography.displaySmall)
Text(
text = "Le serveur cherche, guette les radios et enregistre. Le téléphone ne fait " +
"que récupérer les fichiers prêts — c'est ce qui préserve la batterie.",
style = MaterialTheme.typography.bodySmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
}
ScrollableTabRow(selectedTabIndex = tab, edgePadding = 16.dp) {
SETTINGS_TABS.forEachIndexed { index, label ->
Tab(
selected = tab == index,
onClick = { tab = index },
text = { Text(label, style = MaterialTheme.typography.labelLarge) },
)
}
}
LazyColumn(
contentPadding = contentPadding,
verticalArrangement = Arrangement.spacedBy(12.dp),
modifier = Modifier.fillMaxSize().padding(horizontal = 16.dp),
) {
item { Spacer(Modifier.size(4.dp)) }
when (tab) {
0 -> {
item {
Surface(
color = MaterialTheme.colorScheme.surface,
shape = MaterialTheme.shapes.large,
tonalElevation = 2.dp,
modifier = Modifier.fillMaxWidth(),
) {
Column(Modifier.padding(20.dp)) {
OutlinedTextField(
value = url,
onValueChange = { url = it; probe = null },
label = { Text("Adresse du serveur") },
placeholder = { Text("http://192.168.1.20:8710") },
singleLine = true,
modifier = Modifier.fillMaxWidth(),
)
Spacer(Modifier.size(10.dp))
OutlinedTextField(
value = token,
onValueChange = { token = it; probe = null },
label = { Text("Jeton (rempli par l'appairage)") },
singleLine = true,
visualTransformation = PasswordVisualTransformation(),
modifier = Modifier.fillMaxWidth(),
)
Spacer(Modifier.size(14.dp))
Row(verticalAlignment = Alignment.CenterVertically) {
Button(
enabled = !busy && url.isNotBlank(),
onClick = {
busy = true
probe = null
scope.launch {
container.sync.pair(url).fold(
onSuccess = { name ->
token = container.serverSettings.config.value.token
probe = "Connecté à $name — jeton reçu"
},
onFailure = { probe = it.message ?: "Appairage impossible" },
)
busy = false
}
},
) { Text("Appairer") }
Spacer(Modifier.width(10.dp))
TextButton(
enabled = !busy && url.isNotBlank() && token.isNotBlank(),
onClick = {
busy = true
probe = null
scope.launch {
container.sync.probe(url.trim(), token.trim()).fold(
onSuccess = { name ->
container.serverSettings.update {
it.copy(baseUrl = url.trim(), token = token.trim())
}
probe = "Connecté à $name"
},
onFailure = { probe = it.message ?: "Échec de connexion" },
)
busy = false
}
},
) { Text("Tester") }
Spacer(Modifier.width(10.dp))
if (busy) {
CircularProgressIndicator(strokeWidth = 2.dp, modifier = Modifier.size(22.dp))
} else if (config.isConfigured) {
TextButton(onClick = {
busy = true
scope.launch {
val result = container.sync.sync()
busy = false
onMessage(result.message)
}
}) { Text("Synchroniser") }
}
}
probe?.let {
Spacer(Modifier.size(10.dp))
Text(
text = it,
style = MaterialTheme.typography.bodySmall,
color = if (it.startsWith("Connecté")) MaterialTheme.colorScheme.secondary
else MaterialTheme.colorScheme.error,
)
}
}
}
}
}
1 -> {
item {
Surface(
color = MaterialTheme.colorScheme.surfaceVariant,
shape = MaterialTheme.shapes.large,
modifier = Modifier.fillMaxWidth(),
) {
Row(Modifier.padding(20.dp), verticalAlignment = Alignment.CenterVertically) {
Icon(Icons.Rounded.CloudSync, contentDescription = null)
Spacer(Modifier.width(14.dp))
Column {
Text("Synchronisation automatique", style = MaterialTheme.typography.titleSmall)
Text(
text = "Toutes les six heures, en Wi-Fi non facturé et batterie suffisante.",
style = MaterialTheme.typography.bodySmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
if (config.lastSyncAt > 0) {
Text(
text = "Dernière : ${
SimpleDateFormat("d MMM HH:mm", Locale.FRANCE)
.format(Date(config.lastSyncAt))
} — ${config.lastResult}",
style = MaterialTheme.typography.labelMedium,
color = MaterialTheme.colorScheme.secondary,
)
}
}
}
}
}
}
else -> {
item { UpdateCard(container) }
item {
Surface(
color = MaterialTheme.colorScheme.surface,
shape = MaterialTheme.shapes.large,
tonalElevation = 2.dp,
modifier = Modifier.fillMaxWidth(),
) {
Row(Modifier.padding(20.dp), verticalAlignment = Alignment.CenterVertically) {
Icon(Icons.Rounded.Info, contentDescription = null)
Spacer(Modifier.width(14.dp))
Column(Modifier.weight(1f)) {
Text("À propos", style = MaterialTheme.typography.titleMedium)
Text(
text = "Version ${BuildConfig.VERSION_NAME}",
style = MaterialTheme.typography.labelMedium,
color = MaterialTheme.colorScheme.secondary,
)
}
TextButton(onClick = onOpenAbout) { Text("Ouvrir") }
}
}
}
}
}
item { Spacer(Modifier.size(24.dp)) }
}
}
}
@@ -1,431 +0,0 @@
package fr.tuxgyver.noxely.ui.sources
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.PaddingValues
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.navigationBarsPadding
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.size
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.clickable
import androidx.compose.foundation.lazy.items
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.automirrored.rounded.KeyboardArrowRight
import androidx.compose.material.icons.automirrored.rounded.MenuBook
import androidx.compose.material.icons.rounded.Headphones
import androidx.compose.material.icons.rounded.Info
import androidx.compose.material.icons.rounded.LibraryMusic
import androidx.compose.material.icons.rounded.Public
import androidx.compose.material.icons.rounded.Radio
import androidx.compose.material.icons.rounded.Search
import androidx.compose.material.icons.rounded.Info
import androidx.compose.material.icons.rounded.Link
import androidx.compose.material.icons.rounded.Podcasts
import androidx.compose.material.icons.rounded.Refresh
import androidx.compose.material.icons.rounded.Smartphone
import androidx.compose.material3.Button
import androidx.compose.material3.CircularProgressIndicator
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.FilterChip
import androidx.compose.material3.Icon
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.ModalBottomSheet
import androidx.compose.material3.OutlinedTextField
import androidx.compose.material3.Surface
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton
import androidx.compose.material3.rememberModalBottomSheetState
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.vector.ImageVector
import androidx.compose.ui.unit.dp
import androidx.lifecycle.compose.collectAsStateWithLifecycle
import fr.tuxgyver.noxely.AppContainer
import fr.tuxgyver.noxely.model.SourceKind
import fr.tuxgyver.noxely.sources.CatalogId
import kotlinx.coroutines.launch
@Composable
fun SourcesScreen(
container: AppContainer,
contentPadding: PaddingValues,
onMessage: (String) -> Unit,
onBrowseSource: (SourceKind) -> Unit,
onBrowseCatalog: (CatalogId) -> Unit,
onBrowseRadio: () -> Unit,
onOpenAbout: () -> Unit,
) {
val entries by container.library.entries.collectAsStateWithLifecycle()
var sheet by remember { mutableStateOf<ImportKind?>(null) }
val deviceCount = entries.count { it.source == SourceKind.LOCAL }
val linkCount = entries.count { it.source == SourceKind.URL }
val podcastCount = entries.count { it.source == SourceKind.PODCAST }
LazyColumn(
contentPadding = contentPadding,
verticalArrangement = Arrangement.spacedBy(12.dp),
modifier = Modifier
.fillMaxSize()
.padding(horizontal = 16.dp),
) {
item {
Column(Modifier.padding(top = 12.dp)) {
Text("Sources", style = MaterialTheme.typography.displaySmall)
Text(
"D'où vient le contenu que vous gardez hors connexion.",
style = MaterialTheme.typography.bodyMedium,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
}
}
item {
SourceCard(
icon = Icons.Rounded.Smartphone,
title = "Appareil",
status = "$deviceCount éléments",
description = "Musique et vidéos déjà présentes sur le téléphone. Toujours disponibles.",
actionLabel = "Actualiser",
actionIcon = Icons.Rounded.Refresh,
onAction = { container.library.refreshLocal() },
onOpen = { onBrowseSource(SourceKind.LOCAL) },
)
}
item {
SourceCard(
icon = Icons.Rounded.Link,
title = "Lien direct",
status = "$linkCount éléments",
description = "Une URL vers un fichier audio ou vidéo. Le fichier est ensuite copié dans la cachette.",
actionLabel = "Ajouter un lien",
onAction = { sheet = ImportKind.URL },
onOpen = { onBrowseSource(SourceKind.URL) },
)
}
item {
SourceCard(
icon = Icons.Rounded.Podcasts,
title = "Podcast",
status = "$podcastCount épisodes",
description = "Un flux RSS. Les épisodes deviennent téléchargeables un par un.",
actionLabel = "Ajouter un flux",
onAction = { sheet = ImportKind.RSS },
onOpen = { onBrowseSource(SourceKind.PODCAST) },
)
}
item {
val recordings = entries.count { it.source == SourceKind.RECORDING }
SourceCard(
icon = Icons.Rounded.Radio,
title = "Radio",
status = if (recordings > 0) "$recordings enregistrement(s)" else "Direct et enregistrement",
description = "Les stations les plus écoutées. À suivre en direct, ou à enregistrer pour l'écouter plus tard.",
actionLabel = "Ouvrir la radio",
onAction = onBrowseRadio,
onOpen = onBrowseRadio,
)
}
item {
Spacer(Modifier.size(8.dp))
Text("Catalogues libres de droits", style = MaterialTheme.typography.titleMedium)
Text(
"Rechercher, choisir, emporter. Aucun compte requis.",
style = MaterialTheme.typography.bodySmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
}
items(CatalogId.entries) { catalog ->
SourceCard(
icon = when (catalog) {
CatalogId.LIBRIVOX -> Icons.AutoMirrored.Rounded.MenuBook
CatalogId.WIKIMEDIA -> Icons.Rounded.LibraryMusic
CatalogId.UNDERGROUND -> Icons.Rounded.Headphones
else -> Icons.Rounded.Public
},
title = catalog.title,
status = catalog.license,
description = catalog.description,
actionLabel = "Parcourir",
actionIcon = Icons.Rounded.Search,
onAction = { onBrowseCatalog(catalog) },
onOpen = { onBrowseCatalog(catalog) },
)
}
item {
Spacer(Modifier.size(8.dp))
Text("Services tiers", style = MaterialTheme.typography.titleMedium)
}
item {
Spacer(Modifier.size(8.dp))
UpdateCard(container)
}
item {
SourceCard(
icon = Icons.Rounded.Info,
title = "À propos",
status = "Version ${fr.tuxgyver.noxely.BuildConfig.VERSION_NAME}",
description = "Ce que fait Noxely, ce qu'elle garantit, avec quoi elle est faite et qui en répond.",
actionLabel = "Ouvrir",
onAction = onOpenAbout,
onOpen = onOpenAbout,
)
}
unavailableSourceCards(
listOf(
UnavailableSource(
"Spotify",
"Le SDK Spotify ne donne pas accès au flux audio : la lecture hors connexion n'existe que dans l'application Spotify. Un podcast diffusé aussi en RSS public peut en revanche être ajouté ci-dessus.",
),
UnavailableSource(
"YouTube",
"Les conditions d'utilisation interdisent d'extraire ou de stocker les flux. Le hors-ligne passe par YouTube Premium, dans leur application.",
),
UnavailableSource(
"Google Drive / Photos",
"Techniquement possible pour vos propres fichiers, mais cela demande un identifiant OAuth Google propre à votre compte développeur, qui n'est pas fourni ici.",
),
)
)
}
val current = sheet
if (current != null) {
ImportSheet(
kind = current,
container = container,
onDismiss = { sheet = null },
onMessage = onMessage,
)
}
}
private data class UnavailableSource(val title: String, val explanation: String)
private fun androidx.compose.foundation.lazy.LazyListScope.unavailableSourceCards(sources: List<UnavailableSource>) {
sources.forEach { source ->
item {
Surface(
color = MaterialTheme.colorScheme.surfaceVariant,
shape = MaterialTheme.shapes.medium,
modifier = Modifier.fillMaxWidth(),
) {
Row(Modifier.padding(16.dp)) {
Icon(
imageVector = Icons.Rounded.Info,
contentDescription = null,
tint = MaterialTheme.colorScheme.onSurfaceVariant,
)
Spacer(Modifier.size(12.dp))
Column {
Text(source.title, style = MaterialTheme.typography.titleSmall)
Spacer(Modifier.size(4.dp))
Text(
source.explanation,
style = MaterialTheme.typography.bodySmall,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
}
}
}
}
}
}
@Composable
private fun SourceCard(
icon: ImageVector,
title: String,
status: String,
description: String,
actionLabel: String,
actionIcon: ImageVector? = null,
onAction: () -> Unit,
onOpen: () -> Unit,
) {
Surface(
color = MaterialTheme.colorScheme.surface,
shape = MaterialTheme.shapes.large,
tonalElevation = 2.dp,
modifier = Modifier
.fillMaxWidth()
.clickable(onClick = onOpen),
) {
Column(Modifier.padding(20.dp)) {
Row(verticalAlignment = Alignment.CenterVertically) {
Surface(
color = MaterialTheme.colorScheme.primaryContainer,
shape = MaterialTheme.shapes.small,
) {
Icon(
imageVector = icon,
contentDescription = null,
tint = MaterialTheme.colorScheme.onPrimaryContainer,
modifier = Modifier.padding(10.dp),
)
}
Spacer(Modifier.size(14.dp))
Column(Modifier.weight(1f)) {
Text(title, style = MaterialTheme.typography.titleMedium)
Text(
status,
style = MaterialTheme.typography.labelMedium,
color = MaterialTheme.colorScheme.secondary,
)
}
Icon(
imageVector = Icons.AutoMirrored.Rounded.KeyboardArrowRight,
contentDescription = "Parcourir",
tint = MaterialTheme.colorScheme.onSurfaceVariant,
)
}
Spacer(Modifier.size(10.dp))
Text(
description,
style = MaterialTheme.typography.bodyMedium,
color = MaterialTheme.colorScheme.onSurfaceVariant,
)
Spacer(Modifier.size(12.dp))
Button(onClick = onAction) {
if (actionIcon != null) {
Icon(actionIcon, contentDescription = null, modifier = Modifier.size(18.dp))
Spacer(Modifier.size(8.dp))
}
Text(actionLabel)
}
}
}
}
internal enum class ImportKind(val title: String, val hint: String) {
URL("Ajouter un lien direct", "https://exemple.org/morceau.mp3"),
RSS("Ajouter un flux podcast", "https://exemple.org/podcast.xml"),
}
@OptIn(ExperimentalMaterial3Api::class)
@Composable
private fun ImportSheet(
kind: ImportKind,
container: AppContainer,
onDismiss: () -> Unit,
onMessage: (String) -> Unit,
) {
val sheetState = rememberModalBottomSheetState()
val scope = rememberCoroutineScope()
var url by remember { mutableStateOf("") }
var busy by remember { mutableStateOf(false) }
var error by remember { mutableStateOf<String?>(null) }
var mode by remember { mutableStateOf(kind) }
ModalBottomSheet(onDismissRequest = onDismiss, sheetState = sheetState) {
Column(
Modifier
.padding(horizontal = 24.dp)
.padding(bottom = 24.dp)
.navigationBarsPadding(),
) {
Text(mode.title, style = MaterialTheme.typography.headlineSmall)
Spacer(Modifier.size(16.dp))
Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) {
ImportKind.entries.forEach { option ->
FilterChip(
selected = mode == option,
onClick = { mode = option; error = null },
label = { Text(if (option == ImportKind.URL) "Lien direct" else "Flux podcast") },
)
}
}
Spacer(Modifier.size(16.dp))
OutlinedTextField(
value = url,
onValueChange = { url = it; error = null },
placeholder = { Text(mode.hint) },
singleLine = true,
isError = error != null,
shape = MaterialTheme.shapes.medium,
modifier = Modifier.fillMaxWidth(),
)
error?.let {
Spacer(Modifier.size(8.dp))
Text(it, style = MaterialTheme.typography.bodySmall, color = MaterialTheme.colorScheme.error)
}
Spacer(Modifier.size(20.dp))
Row(
horizontalArrangement = Arrangement.End,
verticalAlignment = Alignment.CenterVertically,
modifier = Modifier.fillMaxWidth(),
) {
TextButton(onClick = onDismiss, enabled = !busy) { Text("Annuler") }
Spacer(Modifier.size(8.dp))
Button(
enabled = !busy && url.isNotBlank(),
onClick = {
busy = true
error = null
scope.launch {
val outcome = runImport(container, mode, url)
busy = false
outcome.fold(
onSuccess = { message ->
onMessage(message)
onDismiss()
},
onFailure = { error = it.message ?: "Import impossible" },
)
}
},
) {
if (busy) {
CircularProgressIndicator(
strokeWidth = 2.dp,
color = MaterialTheme.colorScheme.onPrimary,
modifier = Modifier.size(18.dp),
)
Spacer(Modifier.size(8.dp))
}
Text("Importer")
}
}
}
}
}
private suspend fun runImport(
container: AppContainer,
kind: ImportKind,
url: String,
): Result<String> = when (kind) {
ImportKind.URL -> container.urlImporter.import(url).mapCatching { entry ->
val added = container.imported.add(listOf(entry))
if (added == 0) "« ${entry.title} » est déjà dans la bibliothèque"
else "« ${entry.title} » ajouté"
}
ImportKind.RSS -> container.rssImporter.import(url).mapCatching { feed ->
val added = container.imported.add(feed.episodes)
if (added == 0) "${feed.title} : aucun nouvel épisode"
else "${feed.title} : $added épisode(s) ajouté(s)"
}
}
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.sources
import androidx.compose.foundation.layout.Column
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.ui.theme
import androidx.compose.foundation.isSystemInDarkTheme
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.update
import android.content.Context
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.update
import android.Manifest
@@ -1,3 +1,15 @@
/*
* Noxely — collecte côté serveur, écoute hors connexion côté mobile.
* Copyright © 2026 Johnny (tuxgyver)
*
* Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
* selon les termes de la GNU General Public License, version 3 ou ultérieure,
* telle que publiée par la Free Software Foundation.
*
* Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
* Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
*/
package fr.tuxgyver.noxely.update
import android.content.Context
+19
View File
@@ -0,0 +1,19 @@
# Jeton partagé entre le serveur et l'application Android. Sans lui, l'API refuse tout.
# Générer par exemple avec : openssl rand -base64 24
NOXELY_TOKEN=
# Où sont rangés la base et les fichiers média.
# Par défaut dans le projet, pour que `make server-run` fonctionne sans droits particuliers.
# En service systemd, /var/lib/noxely est plus propre : l'unité le crée elle-même
# (StateDirectory), inutile de le préparer à la main.
NOXELY_DATA=./data
# Interface et port d'écoute.
NOXELY_HOST=0.0.0.0
NOXELY_PORT=8710
# Balayage des radios. Il est continu : un tour enchaîne sur le suivant.
# NOXELY_WATCH_INTERVAL n'est qu'une pause de sécurité entre deux tours.
NOXELY_WATCH_STATIONS=40
NOXELY_WATCH_INTERVAL=5
NOXELY_WATCH_CONCURRENCY=8
+48
View File
@@ -0,0 +1,48 @@
# 🖥️ Noxely — serveur
Le serveur porte tout ce qui coûtait de la batterie au téléphone : la recherche dans les
catalogues, le guet des radios, l'enregistrement et le téléchargement. Le mobile ne fait plus que
récupérer des fichiers prêts.
## Installation
```bash
make server-venv # crée le venv et installe les dépendances
cp server/.env.example server/.env # puis renseigner NOXELY_TOKEN
make server-run # lancement au premier plan, pour essayer
```
L'interface de pilotage est à `http://<hôte>:8710` — recherche, guets, file et bibliothèque.
Le jeton se saisit une fois dans l'en-tête de la page.
## En service
```bash
make server-install # unité systemd (sudo demandé)
make server-status # état
make server-logs # journal suivi
```
## API
| Route | Qui l'utilise |
|---|---|
| `GET /api/health` | tout le monde, sans jeton |
| `GET /api/library?since=<curseur>` | **le mobile** — uniquement ce qui a changé |
| `GET /api/media/{id}/file` | **le mobile** — le fichier |
| `GET /api/search`, `/api/tracks`, `POST /api/queue` | l'interface web |
| `GET/POST/DELETE /api/watches`, `POST /api/watches/sweep` | l'interface web |
Toutes les routes sauf `/api/health` exigent l'en-tête `X-Noxely-Token`.
## Licence
GPL v3, comme le reste du projet — voir [`../LICENSE`](../LICENSE).
## Données
```
$NOXELY_DATA/
├── noxely.sqlite3 index des médias et des guets
└── media/ les fichiers eux-mêmes
```
+27
View File
@@ -0,0 +1,27 @@
# Noxely — serveur : recherche, guet radio, enregistrement et mise à disposition hors ligne.
# Installé par `make server-install` : les marqueurs @...@ sont remplacés à l'installation,
# jamais figés dans le dépôt — le chemin et l'utilisateur diffèrent d'une machine à l'autre.
[Unit]
Description=Noxely - serveur de collecte et de synchronisation
Documentation=file://@PROJECT@/server/README.md
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=@USER@
WorkingDirectory=@PROJECT@/server
# NOXELY_TOKEN, NOXELY_DATA, NOXELY_HOST, NOXELY_PORT
EnvironmentFile=@PROJECT@/server/.env
Environment=PYTHONUNBUFFERED=1
# Crée /var/lib/noxely avec les bons droits : rien à préparer à la main.
StateDirectory=noxely
ExecStart=@PROJECT@/server/venv/bin/python -m noxely_server
Restart=on-failure
RestartSec=10
NoNewPrivileges=true
PrivateTmp=true
[Install]
WantedBy=multi-user.target
+10
View File
@@ -0,0 +1,10 @@
# Noxely — collecte côté serveur, écoute hors connexion côté mobile.
# Copyright © 2026 Johnny (tuxgyver)
#
# Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
# selon les termes de la GNU General Public License, version 3 ou ultérieure,
# telle que publiée par la Free Software Foundation.
#
# Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
# Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
+54
View File
@@ -0,0 +1,54 @@
# Noxely — collecte côté serveur, écoute hors connexion côté mobile.
# Copyright © 2026 Johnny (tuxgyver)
#
# Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
# selon les termes de la GNU General Public License, version 3 ou ultérieure,
# telle que publiée par la Free Software Foundation.
#
# Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
# Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
"""Point d'entrée : `python -m noxely_server`."""
from __future__ import annotations
import sys
import uvicorn
from .config import load
def ensure_usable(data_dir) -> None:
"""Le dossier de données est la première chose qui peut manquer : on le dit clairement."""
try:
data_dir.mkdir(parents=True, exist_ok=True)
probe = data_dir / ".ecriture"
probe.touch()
probe.unlink()
except PermissionError:
print(
f"[noxely] Droits insuffisants sur {data_dir}.\n"
f" Choisissez un dossier accessible dans server/.env (NOXELY_DATA=./data),\n"
f" ou créez-le : sudo install -d -o $(whoami) {data_dir}",
file=sys.stderr,
)
raise SystemExit(1)
except OSError as error:
print(f"[noxely] Dossier de données inutilisable ({data_dir}) : {error}", file=sys.stderr)
raise SystemExit(1)
def main() -> None:
config = load()
ensure_usable(config.data_dir)
# Importé après la vérification : l'application ouvre la base dès son chargement.
from .api import app
print(f"[noxely] données : {config.data_dir}")
print(f"[noxely] écoute : http://{config.host}:{config.port}")
uvicorn.run(app, host=config.host, port=config.port, log_level="info")
if __name__ == "__main__":
main()
+301
View File
@@ -0,0 +1,301 @@
# Noxely — collecte côté serveur, écoute hors connexion côté mobile.
# Copyright © 2026 Johnny (tuxgyver)
#
# Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
# selon les termes de la GNU General Public License, version 3 ou ultérieure,
# telle que publiée par la Free Software Foundation.
#
# Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
# Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
"""API HTTP du serveur Noxely.
Le client Android ne consomme que `/api/health`, `/api/library` et `/api/media/{id}/file` :
tout le reste sert au pilotage depuis un navigateur. Cette séparation est volontaire — le
mobile doit pouvoir se contenter d'un sondage bref, c'est là qu'est le gain de batterie.
"""
from __future__ import annotations
import asyncio
import ipaddress
import secrets
import time
from contextlib import asynccontextmanager
from pathlib import Path
from fastapi import Body, Depends, FastAPI, Header, HTTPException, Query, Request
from fastapi.responses import FileResponse, HTMLResponse, PlainTextResponse, Response
from . import config as config_module
from .sources import catalogs, radio
from .storage import Storage
from .workers import Downloader, Watcher, safe_name
# Client et serveur sortent du même dépôt, à la même version : on lit le fichier
# que la chaîne de publication incrémente, plutôt qu'un numéro à tenir à jour ici.
REPO_ROOT = Path(__file__).resolve().parents[2]
VERSION = (REPO_ROOT / "VERSION").read_text().strip() if (REPO_ROOT / "VERSION").exists() else "0.0.0"
PAIRING_WINDOW_SECONDS = 120
WEB_DIR = Path(__file__).parent / "web"
config = config_module.load()
storage = Storage(config.db_path)
downloader = Downloader(config, storage)
watcher = Watcher(config, storage)
def authorised(x_noxely_token: str = Header(default="")) -> None:
"""Sans jeton valide, le serveur ne répond rien : il expose des fichiers.
Deux formes valent : le jeton maître, qui pilote le serveur depuis le navigateur, et celui
d'un appareil appairé. Les distinguer est ce qui permet de révoquer un téléphone perdu sans
déranger les autres.
"""
if x_noxely_token and x_noxely_token == config.token:
return
device = storage.device_by_token(x_noxely_token) if x_noxely_token else None
if not device:
raise HTTPException(status_code=401, detail="Jeton invalide")
storage.touch_device(device["id"])
@asynccontextmanager
async def lifespan(app: FastAPI):
tasks = [
asyncio.create_task(downloader.run_forever()),
asyncio.create_task(watcher.run_forever()),
]
yield
for task in tasks:
task.cancel()
app = FastAPI(title="Noxely", version=VERSION, lifespan=lifespan)
# --- Ce que consomme le mobile ------------------------------------------
@app.get("/api/health")
def health() -> dict:
return {"name": "Noxely", "version": VERSION}
@app.get("/api/library", dependencies=[Depends(authorised)])
def library(since: int = Query(default=0)) -> dict:
"""Uniquement ce qui a changé depuis le dernier passage du client."""
items = storage.media_since(since)
return {
"items": [m.public() for m in items],
"cursor": items[-1].updated_at if items else since,
}
@app.get("/api/media/{media_id}/file", dependencies=[Depends(authorised)])
def media_file(media_id: str):
item = storage.media(media_id)
if not item or item.state != "ready":
raise HTTPException(status_code=404, detail="Média indisponible")
path = config.media_dir / item.filename
if not path.exists():
raise HTTPException(status_code=404, detail="Fichier absent")
return FileResponse(path, media_type=item.mime, filename=item.filename)
@app.delete("/api/media/{media_id}", dependencies=[Depends(authorised)])
def delete_media(media_id: str) -> dict:
item = storage.delete_media(media_id)
if item:
(config.media_dir / item.filename).unlink(missing_ok=True)
return {"deleted": bool(item)}
# --- Pilotage depuis le navigateur --------------------------------------
@app.get("/api/catalogs", dependencies=[Depends(authorised)])
def list_catalogs() -> dict:
return {
"catalogs": {"all": "Toutes les sources", **catalogs.CATALOGS},
"genres": radio.GENRES,
}
@app.get("/api/search", dependencies=[Depends(authorised)])
async def search(catalog: str, q: str, language: str | None = None) -> dict:
try:
if catalog == "all":
return {"results": await catalogs.search_all(q, language)}
return {"results": await catalogs.search(catalog, q, language)}
except Exception as error:
raise HTTPException(status_code=502, detail=str(error)[:200])
@app.get("/api/tracks", dependencies=[Depends(authorised)])
async def tracks(catalog: str, id: str, title: str = "", kind: str = "Audio") -> dict:
try:
return {"tracks": await catalogs.tracks(catalog, id, title, kind)}
except Exception as error:
raise HTTPException(status_code=502, detail=str(error)[:200])
@app.post("/api/queue", dependencies=[Depends(authorised)])
def queue(payload: dict = Body(...)) -> dict:
"""Met des pistes en file : le téléchargement se fait en tâche de fond."""
added = 0
for track in payload.get("tracks", []):
url = track.get("url")
if not url:
continue
extension = url.split("?")[0].rsplit(".", 1)[-1].lower()
if extension not in ("mp3", "m4a", "ogg", "opus", "flac", "wav", "mp4", "webm"):
extension = "mp3"
storage.add_media(
title=track.get("title") or "Sans titre",
artist=track.get("artist") or "",
source=payload.get("catalog") or "catalogue",
origin=payload.get("origin") or "",
filename=safe_name(track.get("title") or "media", extension),
remote_url=url,
duration_ms=int(track.get("duration_ms") or 0),
artwork_url=track.get("artwork_url"),
)
added += 1
return {"queued": added}
@app.get("/api/radio/stations", dependencies=[Depends(authorised)])
async def radio_stations(genre: str | None = None, name: str | None = None) -> dict:
return {"stations": await radio.stations(genre, name)}
@app.get("/api/watches", dependencies=[Depends(authorised)])
def watches() -> dict:
return {
"watches": storage.watches(),
"recording": watcher.recording,
"sweeps": watcher.sweeps,
"last_sweep": watcher.last_sweep,
}
@app.post("/api/watches", dependencies=[Depends(authorised)])
def add_watch(payload: dict = Body(...)) -> dict:
query = (payload.get("query") or "").strip()
if not query:
raise HTTPException(status_code=400, detail="Requête vide")
return {"id": storage.add_watch(query)}
@app.delete("/api/watches/{watch_id}", dependencies=[Depends(authorised)])
def delete_watch(watch_id: str) -> dict:
storage.delete_watch(watch_id)
return {"deleted": True}
@app.post("/api/watches/sweep", dependencies=[Depends(authorised)])
async def sweep() -> dict:
try:
return await watcher.sweep()
except Exception as error:
# L'annuaire peut être momentanément injoignable : le dire, pas renvoyer une trace.
raise HTTPException(status_code=502, detail=f"Annuaire indisponible : {str(error)[:120]}")
@app.get("/api/queue", dependencies=[Depends(authorised)])
def queue_state() -> dict:
pending = storage.media_since(0, state=None)
return {"items": [m.public() for m in pending if m.state != "ready"][:50]}
#: Fenêtre d'appairage : instant d'expiration, ou None si elle est fermée.
_pairing_until: float | None = None
def _is_private(host: str) -> bool:
"""Le réseau local, et lui seul."""
try:
address = ipaddress.ip_address(host)
return address.is_private or address.is_loopback
except ValueError:
return host in ("localhost", "")
@app.post("/api/pair/open", dependencies=[Depends(authorised)])
def open_pairing() -> dict:
"""Ouvre une fenêtre de deux minutes pendant laquelle un appareil du réseau local peut
réclamer le jeton. Fermée le reste du temps : sinon le jeton ne protégerait plus rien."""
global _pairing_until
_pairing_until = time.time() + PAIRING_WINDOW_SECONDS
return {"open": True, "seconds": PAIRING_WINDOW_SECONDS}
@app.get("/api/pair/state", dependencies=[Depends(authorised)])
def pairing_state() -> dict:
remaining = int(_pairing_until - time.time()) if _pairing_until else 0
return {"open": remaining > 0, "seconds": max(0, remaining)}
@app.get("/api/devices", dependencies=[Depends(authorised)])
def devices() -> dict:
return {"devices": storage.devices()}
@app.delete("/api/devices/{device_id}", dependencies=[Depends(authorised)])
def revoke_device(device_id: str) -> dict:
"""Révoque un appareil : son jeton cesse immédiatement d'être accepté."""
return {"revoked": storage.delete_device(device_id)}
@app.post("/api/pair")
def pair(request: Request, payload: dict = Body(default={})) -> dict:
"""Livre le jeton à un appareil du réseau local, pendant la fenêtre d'appairage.
La fenêtre se referme dès qu'un appareil s'est servi : une ouverture, un appairage.
"""
global _pairing_until
client = request.client.host if request.client else ""
if not _pairing_until or time.time() > _pairing_until:
raise HTTPException(
status_code=403,
detail="Aucun appairage en cours. Ouvrez-en un depuis l'interface du serveur.",
)
if not _is_private(client):
raise HTTPException(status_code=403, detail="Appairage réservé au réseau local")
_pairing_until = None
# Chaque appairage reçoit son propre jeton : révoquer l'un n'atteint pas les autres.
token = secrets.token_urlsafe(24)
name = str(payload.get("name") or "Appareil").strip()[:60]
storage.add_device(name, token)
return {"token": token, "name": "Noxely", "version": VERSION, "device": name}
@app.get("/api/bootstrap")
def bootstrap(request: Request) -> dict:
"""Livre le jeton — uniquement à une requête venue de la machine elle-même.
Depuis un autre poste, il faut le saisir : c'est précisément ce que le jeton protège.
`make server-token` l'affiche pour le copier.
"""
client = request.client.host if request.client else ""
if client not in ("127.0.0.1", "::1", "localhost"):
raise HTTPException(status_code=403, detail="Jeton lisible seulement en local")
return {"token": config.token}
@app.get("/api/changelog", response_class=PlainTextResponse)
def changelog() -> str:
"""Le journal du dépôt, lu à la demande plutôt que recopié dans la page."""
path = REPO_ROOT / "CHANGELOG.md"
return path.read_text(encoding="utf-8") if path.exists() else ""
@app.get("/about.js", response_class=PlainTextResponse)
def about_script() -> Response:
return Response(
(WEB_DIR / "about.js").read_text(encoding="utf-8"),
media_type="application/javascript; charset=utf-8",
)
@app.get("/", response_class=HTMLResponse)
def index() -> str:
return (WEB_DIR / "index.html").read_text(encoding="utf-8")
+77
View File
@@ -0,0 +1,77 @@
# Noxely — collecte côté serveur, écoute hors connexion côté mobile.
# Copyright © 2026 Johnny (tuxgyver)
#
# Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
# selon les termes de la GNU General Public License, version 3 ou ultérieure,
# telle que publiée par la Free Software Foundation.
#
# Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
# Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
"""Configuration du serveur Noxely, lue de l'environnement.
Aucune valeur sensible n'est écrite dans le dépôt : le jeton et les chemins viennent d'un
fichier .env local, à l'image des autres services de la maison.
"""
from __future__ import annotations
import os
import secrets
from dataclasses import dataclass
from pathlib import Path
def _persisted_token(data_dir: Path) -> str:
"""Jeton auto-généré, conservé entre deux démarrages.
Un jeton tiré à chaque lancement obligerait à reconfigurer le téléphone après le moindre
redémarrage : il est donc écrit une fois, en lecture seule pour son propriétaire.
"""
path = data_dir / "token"
if path.exists():
existing = path.read_text().strip()
if existing:
return existing
token = secrets.token_urlsafe(24)
data_dir.mkdir(parents=True, exist_ok=True)
path.write_text(token + "\n")
path.chmod(0o600)
print(f"[noxely] jeton généré et conservé dans {path}")
return token
@dataclass(frozen=True)
class Config:
data_dir: Path
token: str
host: str
port: int
#: Nombre de stations balayées à chaque passage du guet.
watch_stations: int
#: Pause entre deux balayages, en secondes. Le balayage est continu : cette pause n'est
#: qu'un garde-fou pour ne pas marteler l'annuaire si un tour échoue instantanément.
watch_interval: int
#: Stations sondées en parallèle. Plus il est haut, plus un tour complet est bref.
watch_concurrency: int
@property
def media_dir(self) -> Path:
return self.data_dir / "media"
@property
def db_path(self) -> Path:
return self.data_dir / "noxely.sqlite3"
def load() -> Config:
data_dir = Path(os.environ.get("NOXELY_DATA", "./data")).expanduser().resolve()
token = os.environ.get("NOXELY_TOKEN", "").strip() or _persisted_token(data_dir)
return Config(
data_dir=data_dir,
token=token,
host=os.environ.get("NOXELY_HOST", "0.0.0.0"),
port=int(os.environ.get("NOXELY_PORT", "8710")),
watch_stations=int(os.environ.get("NOXELY_WATCH_STATIONS", "40")),
watch_interval=int(os.environ.get("NOXELY_WATCH_INTERVAL", "5")),
watch_concurrency=int(os.environ.get("NOXELY_WATCH_CONCURRENCY", "8")),
)
+16
View File
@@ -0,0 +1,16 @@
# Noxely — collecte côté serveur, écoute hors connexion côté mobile.
# Copyright © 2026 Johnny (tuxgyver)
#
# Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
# selon les termes de la GNU General Public License, version 3 ou ultérieure,
# telle que publiée par la Free Software Foundation.
#
# Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
# Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
"""Catalogues libres et annuaire radio, portés depuis le client Android.
Les pièges vérifiés côté mobile restent valables ici et sont conservés en commentaire :
LibriVox ignore son paramètre `language`, archive.org sert des éléments en accès restreint,
et un titre ICY court jusqu'au « '; » et non jusqu'à la première apostrophe.
"""
+245
View File
@@ -0,0 +1,245 @@
# Noxely — collecte côté serveur, écoute hors connexion côté mobile.
# Copyright © 2026 Johnny (tuxgyver)
#
# Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
# selon les termes de la GNU General Public License, version 3 ou ultérieure,
# telle que publiée par la Free Software Foundation.
#
# Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
# Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
"""Recherche dans les catalogues libres de droits."""
from __future__ import annotations
import asyncio
import re
import urllib.parse
import httpx
# Wikimedia refuse (403) les agents génériques : sa politique demande un nom identifiable
# et un moyen de contact. Les autres services s'en accommodent aussi.
UA = {"User-Agent": "Noxely/1.0 (https://git.tuxtech.fr/tuxgyver/Noxely)"}
TIMEOUT = httpx.Timeout(30.0, connect=15.0)
AUDIO_EXT = (".mp3", ".m4a", ".ogg", ".opus", ".flac", ".wav")
VIDEO_EXT = (".mp4", ".m4v", ".webm", ".ogv")
CATALOGS = {
"archive": "Internet Archive",
"underground": "Underground (netlabels)",
"librivox": "LibriVox",
"wikimedia": "Wikimedia Commons",
}
async def search_all(query: str, language: str | None = None) -> list[dict]:
"""Interroge les quatre catalogues en parallèle et fond les résultats.
Chaque ligne porte son catalogue d'origine : c'est lui qu'il faudra pour en lister les
pistes. Un catalogue en panne n'empêche pas les autres de répondre — on préfère une liste
incomplète à une erreur globale.
"""
names = list(CATALOGS)
outcomes = await asyncio.gather(
*(search(name, query, language) for name in names), return_exceptions=True
)
merged: list[dict] = []
for name, outcome in zip(names, outcomes):
if isinstance(outcome, Exception):
continue
for item in outcome:
merged.append({**item, "catalog": name})
# Les résultats les plus légers d'abord : sur un téléphone, la taille prime.
merged.sort(key=lambda item: item["size"] or 1 << 62)
return merged
async def search(catalog: str, query: str, language: str | None = None) -> list[dict]:
if catalog == "librivox":
return await _librivox(query, language)
if catalog == "wikimedia":
return await _wikimedia(query)
collections = ["netlabels", "freemusicarchive"] if catalog == "underground" else []
return await _archive(query, language, collections)
async def tracks(catalog: str, item_id: str, title: str = "", kind: str = "Audio") -> list[dict]:
"""Les fichiers d'un résultat : un album en a plusieurs, un morceau un seul."""
if catalog == "librivox":
return await _librivox_tracks(item_id)
if catalog == "wikimedia":
return [{"title": title or item_id, "artist": "Wikimedia Commons", "url": item_id, "size": 0}]
return await _archive_tracks(item_id, title, kind)
# --- archive.org --------------------------------------------------------
async def _archive(query: str, language: str | None, collections: list[str]) -> list[dict]:
clauses = [f"({query})", "mediatype:(audio OR movies)"]
if language:
clauses.append(f"language:({language})")
if collections:
clauses.append("collection:(" + " OR ".join(collections) + ")")
# Les éléments restreints répondent 401 au téléchargement : écartés dès la recherche.
clauses.append("NOT access-restricted-item:true")
params = {
"q": " AND ".join(clauses),
"fl[]": ["identifier", "title", "creator", "mediatype", "item_size"],
"rows": "30", "page": "1", "output": "json",
}
async with httpx.AsyncClient(headers=UA, timeout=TIMEOUT) as client:
response = await client.get("https://archive.org/advancedsearch.php", params=params)
response.raise_for_status()
docs = response.json().get("response", {}).get("docs", [])
return [
{
"id": doc["identifier"],
"title": _first(doc.get("title")) or doc["identifier"],
"artist": _first(doc.get("creator")) or "Internet Archive",
"kind": "Vidéo" if doc.get("mediatype") == "movies" else "Audio",
"catalog": "archive",
"size": int(doc.get("item_size") or 0),
}
for doc in docs if doc.get("identifier")
]
async def _archive_tracks(identifier: str, title: str, kind: str) -> list[dict]:
async with httpx.AsyncClient(headers=UA, timeout=TIMEOUT, follow_redirects=True) as client:
response = await client.get(f"https://archive.org/metadata/{identifier}")
response.raise_for_status()
meta = response.json()
if str(meta.get("metadata", {}).get("access-restricted-item", "")).lower() == "true":
raise ValueError(f"« {title or identifier} » est en accès restreint")
wants_video = kind == "Vidéo"
extensions = VIDEO_EXT if wants_video else AUDIO_EXT
files = [f for f in meta.get("files", []) if f.get("name", "").lower().endswith(extensions)]
if not files:
raise ValueError("Aucun fichier lisible dans cet élément")
# Un élément expose l'original et ses dérivés : on garde le plus léger de chaque morceau,
# autant de pistes que d'œuvres et non que de formats.
groups: dict[str, dict] = {}
for entry in files:
stem = entry["name"].rsplit(".", 1)[0].lower()
size = int(entry.get("size") or 1 << 62)
if stem not in groups or size < int(groups[stem].get("size") or 1 << 62):
groups[stem] = entry
out = []
for entry in sorted(groups.values(), key=lambda f: f["name"]):
name = entry["name"]
out.append({
"title": entry.get("title") or name.rsplit(".", 1)[0],
"artist": title or identifier,
"url": f"https://archive.org/download/{identifier}/" + urllib.parse.quote(name),
"size": int(entry.get("size") or 0),
"duration_ms": int(float(entry.get("length") or 0) * 1000),
"artwork_url": f"https://archive.org/services/img/{identifier}",
})
return out
# --- LibriVox -----------------------------------------------------------
async def _librivox(query: str, language: str | None) -> list[dict]:
term = urllib.parse.quote(query.strip())
words = query.strip().split()
# `title` est une correspondance exacte sans « ^ », et `author` ne matche que le nom de
# famille : trois interrogations valent mieux qu'une qui échouerait.
criteria = [f"title=^{term}", f"author={term}"]
if len(words) > 1:
criteria.append("author=" + urllib.parse.quote(words[-1]))
seen: dict[str, dict] = {}
limit = 25 if not language else 100
async with httpx.AsyncClient(headers=UA, timeout=TIMEOUT) as client:
for criterion in criteria:
url = f"https://librivox.org/api/feed/audiobooks/?format=json&limit={limit}&{criterion}"
response = await client.get(url)
if response.status_code == 404: # « aucun résultat », pas une panne
continue
response.raise_for_status()
for book in response.json().get("books", []):
# Le paramètre `language` de l'API est accepté puis ignoré : filtrage ici.
if language and (book.get("language") or "").lower() != language.lower():
continue
feed = book.get("url_rss")
if feed and feed not in seen:
authors = ", ".join(
" ".join(filter(None, [a.get("first_name"), a.get("last_name")]))
for a in book.get("authors", [])
)
seen[feed] = {
"id": feed,
"title": book.get("title") or "Livre audio",
"artist": authors or "LibriVox",
"kind": "Audio",
"size": 0,
"catalog": "librivox",
}
return list(seen.values())
async def _librivox_tracks(feed_url: str) -> list[dict]:
async with httpx.AsyncClient(headers=UA, timeout=TIMEOUT, follow_redirects=True) as client:
response = await client.get(feed_url)
response.raise_for_status()
xml = response.text
title = re.search(r"<title>(.*?)</title>", xml, re.S)
book = (title.group(1).strip() if title else "Livre audio")
out = []
for item in re.findall(r"<item>(.*?)</item>", xml, re.S):
url = re.search(r'<enclosure[^>]*url="([^"]+)"', item)
name = re.search(r"<title>(.*?)</title>", item, re.S)
if url:
out.append({
"title": (name.group(1).strip() if name else "Épisode"),
"artist": book,
"url": url.group(1),
"size": 0,
})
return out
# --- Wikimedia Commons --------------------------------------------------
async def _wikimedia(query: str) -> list[dict]:
params = {
"action": "query", "format": "json", "generator": "search",
"gsrsearch": f"filetype:audio {query.strip()}", "gsrnamespace": "6", "gsrlimit": "30",
"prop": "imageinfo", "iiprop": "url|size|mime|extmetadata",
}
async with httpx.AsyncClient(headers=UA, timeout=TIMEOUT) as client:
response = await client.get("https://commons.wikimedia.org/w/api.php", params=params)
response.raise_for_status()
pages = response.json().get("query", {}).get("pages", {})
out = []
for page in pages.values():
info = (page.get("imageinfo") or [{}])[0]
url = info.get("url")
if not url or not url.split("?")[0].lower().endswith(AUDIO_EXT):
continue
licence = (info.get("extmetadata", {}).get("LicenseShortName", {}) or {}).get("value")
out.append({
"id": url,
"title": page.get("title", "").removeprefix("File:").rsplit(".", 1)[0],
"artist": licence or "Wikimedia Commons",
"kind": "Audio",
"size": int(info.get("size") or 0),
"catalog": "wikimedia",
})
return out
def _first(value):
if isinstance(value, list):
return value[0] if value else None
return value
+102
View File
@@ -0,0 +1,102 @@
# Noxely — collecte côté serveur, écoute hors connexion côté mobile.
# Copyright © 2026 Johnny (tuxgyver)
#
# Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
# selon les termes de la GNU General Public License, version 3 ou ultérieure,
# telle que publiée par la Free Software Foundation.
#
# Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
# Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
"""Annuaire des stations et lecture des métadonnées ICY."""
from __future__ import annotations
import asyncio
import re
import urllib.parse
import httpx
UA = {"User-Agent": "Noxely/1.0 (https://git.tuxtech.fr/tuxgyver/Noxely)"}
BASE = "https://de1.api.radio-browser.info/json/stations/search"
#: Un titre ICY court jusqu'au « '; » : les apostrophes y sont trop fréquentes pour s'arrêter
#: à la première (« Ain't That a Kick in the Head » deviendrait « Ain »).
STREAM_TITLE = re.compile(r"StreamTitle='(.*?)';")
GENRES = ["pop", "rock", "jazz", "classical", "electronic", "news", "chanson"]
async def stations(genre: str | None = None, name: str | None = None, limit: int = 60) -> list[dict]:
params = {"limit": str(limit), "hidebroken": "true", "order": "clickcount", "reverse": "true"}
if genre:
params["tag"] = genre
if name:
params["name"] = name
# L'annuaire est un service communautaire : une coupure passagère ne doit pas faire
# tomber le balayage. Mesuré en conditions réelles, d'où cette seconde tentative.
rows = None
async with httpx.AsyncClient(headers=UA, timeout=httpx.Timeout(30.0)) as client:
for attempt in range(2):
try:
response = await client.get(BASE, params=params)
response.raise_for_status()
rows = response.json()
break
except Exception:
if attempt == 1:
raise
await asyncio.sleep(2)
out = []
for row in rows:
url = row.get("url_resolved") or ""
# Les flux HLS se lisent mais ne s'enregistrent pas en copiant les octets.
if int(row.get("hls") or 0) != 0 or not url.startswith("http"):
continue
out.append({
"id": row.get("stationuuid") or url,
"name": (row.get("name") or "Station").strip(),
"url": url,
"codec": row.get("codec") or "",
"bitrate": int(row.get("bitrate") or 0),
"country": row.get("country") or "",
})
return out
async def now_playing(stream_url: str) -> str | None:
"""Le morceau diffusé à l'instant : aucun annuaire ne l'expose, il faut ouvrir le flux."""
headers = {**UA, "Icy-MetaData": "1"}
try:
async with httpx.AsyncClient(headers=headers, timeout=httpx.Timeout(10.0)) as client:
async with client.stream("GET", stream_url) as response:
if response.status_code >= 300:
return None
interval = int(response.headers.get("icy-metaint") or 0)
if interval <= 0:
return None
return await _read_title(response, interval)
except Exception:
return None
async def _read_title(response, interval: int) -> str | None:
# Client asynchrone : `iter_bytes` n'itère rien ici, il faut `aiter_bytes`.
buffer = bytearray()
needed = interval + 1
async for chunk in response.aiter_bytes():
buffer.extend(chunk)
if len(buffer) < needed:
continue
length = buffer[interval] * 16
if length == 0:
return None
needed = interval + 1 + length
if len(buffer) < needed:
continue
meta = bytes(buffer[interval + 1:needed]).decode("utf-8", "replace")
found = STREAM_TITLE.search(meta)
return found.group(1).strip() or None if found else None
return None
+230
View File
@@ -0,0 +1,230 @@
# Noxely — collecte côté serveur, écoute hors connexion côté mobile.
# Copyright © 2026 Johnny (tuxgyver)
#
# Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
# selon les termes de la GNU General Public License, version 3 ou ultérieure,
# telle que publiée par la Free Software Foundation.
#
# Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
# Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
"""Index des médias et des guets, en SQLite.
Les fichiers vivent sur le disque ; la base ne porte que leurs métadonnées et l'état de la
synchronisation. Un client ne demande que ce qui a changé depuis son dernier passage, d'où le
champ `updated_at` sur chaque ligne.
"""
from __future__ import annotations
import sqlite3
import time
import uuid
from dataclasses import asdict, dataclass
from pathlib import Path
SCHEMA = """
CREATE TABLE IF NOT EXISTS media (
id TEXT PRIMARY KEY,
title TEXT NOT NULL,
artist TEXT NOT NULL DEFAULT '',
source TEXT NOT NULL,
origin TEXT NOT NULL DEFAULT '',
filename TEXT NOT NULL,
mime TEXT NOT NULL DEFAULT 'audio/mpeg',
size INTEGER NOT NULL DEFAULT 0,
duration_ms INTEGER NOT NULL DEFAULT 0,
artwork_url TEXT,
state TEXT NOT NULL DEFAULT 'pending',
error TEXT,
remote_url TEXT,
created_at INTEGER NOT NULL,
updated_at INTEGER NOT NULL
);
CREATE INDEX IF NOT EXISTS media_updated ON media(updated_at);
CREATE TABLE IF NOT EXISTS devices (
id TEXT PRIMARY KEY,
name TEXT NOT NULL,
token TEXT NOT NULL UNIQUE,
created_at INTEGER NOT NULL,
last_seen INTEGER
);
CREATE INDEX IF NOT EXISTS devices_token ON devices(token);
CREATE TABLE IF NOT EXISTS watches (
id TEXT PRIMARY KEY,
query TEXT NOT NULL,
created_at INTEGER NOT NULL,
scans INTEGER NOT NULL DEFAULT 0,
last_scan INTEGER,
found_at INTEGER,
found_on TEXT,
found_title TEXT
);
"""
@dataclass
class Media:
id: str
title: str
artist: str
source: str
origin: str
filename: str
mime: str
size: int
duration_ms: int
artwork_url: str | None
state: str
error: str | None
remote_url: str | None
created_at: int
updated_at: int
def public(self) -> dict:
"""Vue destinée au client : ni chemin local, ni URL d'origine."""
data = asdict(self)
data.pop("remote_url")
data.pop("filename")
return data
def now() -> int:
return int(time.time() * 1000)
class Storage:
def __init__(self, db_path: Path) -> None:
db_path.parent.mkdir(parents=True, exist_ok=True)
self._db = sqlite3.connect(db_path, check_same_thread=False)
self._db.row_factory = sqlite3.Row
self._db.executescript(SCHEMA)
self._db.commit()
# --- Médias ---------------------------------------------------------
def add_media(self, *, title: str, artist: str, source: str, origin: str,
filename: str, remote_url: str | None, mime: str = "audio/mpeg",
duration_ms: int = 0, artwork_url: str | None = None,
state: str = "pending") -> str:
media_id = uuid.uuid4().hex
stamp = now()
self._db.execute(
"INSERT INTO media (id,title,artist,source,origin,filename,mime,size,duration_ms,"
"artwork_url,state,error,remote_url,created_at,updated_at) "
"VALUES (?,?,?,?,?,?,?,0,?,?,?,NULL,?,?,?)",
(media_id, title, artist, source, origin, filename, mime, duration_ms,
artwork_url, state, remote_url, stamp, stamp),
)
self._db.commit()
return media_id
def update_media(self, media_id: str, **fields) -> None:
if not fields:
return
fields["updated_at"] = now()
assignments = ", ".join(f"{key} = ?" for key in fields)
self._db.execute(
f"UPDATE media SET {assignments} WHERE id = ?", (*fields.values(), media_id)
)
self._db.commit()
def media(self, media_id: str) -> Media | None:
row = self._db.execute("SELECT * FROM media WHERE id = ?", (media_id,)).fetchone()
return Media(**dict(row)) if row else None
def media_since(self, since: int = 0, state: str | None = "ready") -> list[Media]:
query = "SELECT * FROM media WHERE updated_at > ?"
params: list = [since]
if state:
query += " AND state = ?"
params.append(state)
query += " ORDER BY updated_at ASC"
return [Media(**dict(r)) for r in self._db.execute(query, params)]
def pending_downloads(self) -> list[Media]:
return [
Media(**dict(r))
for r in self._db.execute(
"SELECT * FROM media WHERE state IN ('pending','failed') AND remote_url IS NOT NULL "
"ORDER BY created_at ASC LIMIT 20"
)
]
def delete_media(self, media_id: str) -> Media | None:
item = self.media(media_id)
if item:
self._db.execute("DELETE FROM media WHERE id = ?", (media_id,))
self._db.commit()
return item
# --- Appareils ------------------------------------------------------
def add_device(self, name: str, token: str) -> str:
device_id = uuid.uuid4().hex
self._db.execute(
"INSERT INTO devices (id,name,token,created_at) VALUES (?,?,?,?)",
(device_id, name.strip() or "Appareil", token, now()),
)
self._db.commit()
return device_id
def device_by_token(self, token: str) -> dict | None:
row = self._db.execute("SELECT * FROM devices WHERE token = ?", (token,)).fetchone()
return dict(row) if row else None
def touch_device(self, device_id: str) -> None:
"""Dernière utilisation : c'est ce qui permet de reconnaître un appareil oublié."""
self._db.execute("UPDATE devices SET last_seen = ? WHERE id = ?", (now(), device_id))
self._db.commit()
def devices(self) -> list[dict]:
return [
# Le jeton n'est jamais renvoyé : le lister reviendrait à le distribuer.
{k: v for k, v in dict(row).items() if k != "token"}
for row in self._db.execute("SELECT * FROM devices ORDER BY created_at DESC")
]
def delete_device(self, device_id: str) -> bool:
cursor = self._db.execute("DELETE FROM devices WHERE id = ?", (device_id,))
self._db.commit()
return cursor.rowcount > 0
# --- Guets ----------------------------------------------------------
def add_watch(self, query: str) -> str:
watch_id = uuid.uuid4().hex
self._db.execute(
"INSERT INTO watches (id,query,created_at) VALUES (?,?,?)",
(watch_id, query.strip(), now()),
)
self._db.commit()
return watch_id
def watches(self) -> list[dict]:
return [dict(r) for r in self._db.execute("SELECT * FROM watches ORDER BY created_at DESC")]
def pending_watches(self) -> list[dict]:
return [dict(r) for r in self._db.execute("SELECT * FROM watches WHERE found_at IS NULL")]
def mark_watch_found(self, watch_id: str, station: str, title: str) -> None:
self._db.execute(
"UPDATE watches SET found_at=?, found_on=?, found_title=? WHERE id=?",
(now(), station, title, watch_id),
)
self._db.commit()
def mark_watches_scanned(self, ids: list[str]) -> None:
if not ids:
return
stamp = now()
self._db.executemany(
"UPDATE watches SET scans = scans + 1, last_scan = ? WHERE id = ?",
[(stamp, i) for i in ids],
)
self._db.commit()
def delete_watch(self, watch_id: str) -> None:
self._db.execute("DELETE FROM watches WHERE id = ?", (watch_id,))
self._db.commit()
+73
View File
@@ -0,0 +1,73 @@
// Noxely — collecte côté serveur, écoute hors connexion côté mobile.
// Copyright © 2026 Johnny (tuxgyver)
//
// Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
// selon les termes de la GNU General Public License, version 3 ou ultérieure,
// telle que publiée par la Free Software Foundation.
//
// Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
// Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
// Contenu de la page « À propos », séparé de son rendu.
// Tout ce qui est écrit ici se vérifie dans le dépôt : une fonction décrite existe, une garantie
// annoncée est tenue par du code. La version vient de /api/health, jamais recopiée.
const ABOUT = {
name: 'Noxely — serveur',
tagline: 'Il cherche, il guette, il enregistre. Le téléphone n\'a plus qu\'à écouter.',
repository: 'https://git.tuxtech.fr/tuxgyver/Noxely',
author: 'Johnny',
authorRole: 'Conception, direction et supervision',
authorship:
'Application développée avec l\'assistance de l\'IA, sous la direction et la supervision de Johnny.',
license: 'GPL v3',
copyright: 'Copyright © 2026 Johnny (tuxgyver)',
// Ce que fait le serveur, du point de vue de qui s'en sert.
features: [
['Chercher partout à la fois',
'Internet Archive, Underground (netlabels et Free Music Archive), LibriVox et Wikimedia ' +
'Commons sont interrogés en parallèle, les résultats fondus et les plus légers mis en tête.'],
['Choisir avant de télécharger',
'Un album ou un livre affiche ses pistes avec leur taille : on met en file ce qu\'on veut, ' +
'pas l\'ensemble.'],
['Guetter un morceau sur les radios',
'On nomme un titre sans désigner de station : les plus écoutées sont balayées en continu, ' +
'et l\'enregistrement part dès que l\'une le diffuse.'],
['Enregistrer un direct',
'La capture prend le nom du morceau annoncé par la station, et s\'arrête quand il cède la ' +
'place au suivant.'],
['Tenir la file',
'Les téléchargements s\'enchaînent seuls ; un échec est repris, son état reste visible.'],
['Servir le mobile',
'L\'application demande ce qui a changé depuis son dernier passage et récupère des fichiers ' +
'déjà prêts — c\'est ce qui lui épargne sa batterie.'],
],
guaranteesIntro:
'Noxely est un outil personnel : rien n\'y transite par un service tiers, et le serveur ne ' +
'répond qu\'à ce qui présente un jeton valide.',
// Chaque promesse est tenue par du code.
guarantees: [
'Aucun compte, aucune clé d\'API : les quatre catalogues et l\'annuaire radio sont publics.',
'Toute route de données exige un jeton — celui du serveur, ou celui d\'un appareil appairé ; ' +
'seuls l\'état de santé, la page et ses ressources répondent sans.',
'Chaque appareil reçoit son propre jeton : en révoquer un ne coupe pas les autres.',
'Les jetons d\'appareil ne sont jamais renvoyés par la route qui les liste.',
'L\'appairage n\'est possible que pendant une fenêtre ouverte depuis cette interface, deux ' +
'minutes durant, une seule fois, et depuis le réseau local uniquement.',
'Les catalogues ne proposent que des œuvres libres ou du domaine public ; les éléments en ' +
'accès restreint sont écartés avant même d\'être affichés.',
'Une synchronisation partielle ne fait pas avancer le curseur du client : rien n\'est perdu.',
],
// Couche → outils.
stack: [
['Service', 'Python, FastAPI, uvicorn, unité systemd'],
['Données', 'SQLite pour l\'index, fichiers sur disque pour les médias'],
['Collecte', 'httpx asynchrone, flux ICY pour les titres de radio'],
['Catalogues', 'Internet Archive, netlabels, LibriVox, Wikimedia Commons'],
['Interface', 'HTML, CSS et JavaScript sans dépendance'],
['Synchronisation', 'HTTP avec jeton, curseur incrémental côté client'],
],
};
+442
View File
@@ -0,0 +1,442 @@
<!doctype html>
<!--
Noxely — collecte côté serveur, écoute hors connexion côté mobile.
Copyright © 2026 Johnny (tuxgyver)
Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
selon les termes de la GNU General Public License, version 3 ou ultérieure,
telle que publiée par la Free Software Foundation.
Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
-->
<html lang="fr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Noxely — serveur</title>
<style>
:root { --bg:#faf7ff; --card:#fff; --ink:#1c1b22; --muted:#5c5670; --accent:#6b4eff;
--mint:#11a894; --line:#e6e0f0; }
@media (prefers-color-scheme: dark) {
:root { --bg:#120d1c; --card:#1b1033; --ink:#e8e0f0; --muted:#a79fbb; --line:#2f2743; }
}
* { box-sizing: border-box; }
body { margin:0; background:var(--bg); color:var(--ink); font:15px/1.5 system-ui,sans-serif; }
header { padding:18px 20px; border-bottom:1px solid var(--line); display:flex;
align-items:center; gap:12px; flex-wrap:wrap; }
h1 { font-size:19px; margin:0; }
main { max-width:920px; margin:0 auto; padding:20px; }
.tabs { display:flex; gap:6px; flex-wrap:wrap; margin-bottom:18px; }
.tabs button { background:none; border:1px solid var(--line); border-radius:999px;
padding:7px 15px; color:var(--muted); cursor:pointer; font-size:14px; }
.tabs button[aria-selected="true"] { background:var(--accent); border-color:var(--accent); color:#fff; }
.card { background:var(--card); border:1px solid var(--line); border-radius:14px;
padding:12px 14px; margin-bottom:8px; display:flex; gap:12px; align-items:center; }
.card .grow { flex:1; min-width:0; }
.card b { display:block; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
.card small { color:var(--muted); }
input, select { padding:9px 12px; border:1px solid var(--line); border-radius:10px;
background:var(--card); color:var(--ink); font-size:14px; }
input[type=text] { flex:1; min-width:160px; }
button.go { background:var(--accent); color:#fff; border:none; border-radius:10px;
padding:9px 16px; cursor:pointer; font-size:14px; }
button.ghost { background:none; border:1px solid var(--line); border-radius:10px;
padding:7px 12px; cursor:pointer; color:var(--muted); }
.row { display:flex; gap:8px; margin-bottom:14px; flex-wrap:wrap; }
.pill { font-size:12px; padding:3px 9px; border-radius:999px; background:var(--line); color:var(--muted); }
.pill.ok { background:rgba(17,168,148,.16); color:var(--mint); }
.pill.warn { background:rgba(224,98,155,.16); color:#e0629b; }
.empty { color:var(--muted); text-align:center; padding:40px 10px; }
/* Page « À propos » : en-tête d'identité figé, corps en sous-onglets. */
.about-head { display:flex; gap:16px; align-items:center; margin-bottom:16px; }
.about-logo { width:80px; height:80px; border-radius:22px; background:var(--accent);
display:grid; place-items:center; font-size:40px; flex:none; }
.about-head h2 { margin:0 0 2px; font-size:20px; }
.about-head p { margin:0 0 8px; color:var(--muted); font-size:14px; }
.pill.accent { background:var(--accent); color:#fff; }
.subtabs { display:flex; gap:6px; flex-wrap:wrap; margin-bottom:14px; }
.subtabs button { background:none; border:1px solid var(--line); border-radius:999px;
padding:5px 12px; color:var(--muted); cursor:pointer; font-size:13px; }
.subtabs button[aria-selected="true"] { border-color:var(--accent); color:var(--accent); }
.about-body { max-height:none; }
.about-body .card { display:block; }
.about-body ul { margin:0; padding-left:20px; }
.about-body li { margin:5px 0; }
.tech { width:100%; border-collapse:collapse; }
.tech td { padding:9px 4px; border-bottom:1px solid var(--line); vertical-align:top; }
.tech td:first-child { color:var(--muted); width:38%; }
.log h4 { margin:0 0 4px; font-size:15px; }
</style>
</head>
<body>
<header>
<h1>🎧 Noxely — serveur</h1>
<span id="status" class="pill">…</span>
<span class="grow" style="flex:1"></span>
<button class="go" onclick="openPairing()">📱 Appairer</button>
</header>
<main>
<div class="tabs">
<button onclick="show('search')" aria-selected="true" id="t-search">🔎 Rechercher</button>
<button onclick="show('watch')" aria-selected="false" id="t-watch">📡 Guets</button>
<button onclick="show('queue')" aria-selected="false" id="t-queue">⏳ File</button>
<button onclick="show('library')" aria-selected="false" id="t-library">📚 Bibliothèque</button>
<button onclick="show('devices')" aria-selected="false" id="t-devices">📱 Appareils</button>
<button onclick="show('settings')" aria-selected="false" id="t-settings">⚙️ Réglages</button>
<button onclick="show('about')" aria-selected="false" id="t-about">ℹ️ À propos</button>
</div>
<section id="p-search">
<div class="row">
<select id="catalog"></select>
<input type="text" id="q" placeholder="Titre, artiste, album…" onkeydown="if(event.key==='Enter')doSearch()">
<button class="go" onclick="doSearch()">Chercher</button>
</div>
<div id="results"></div>
</section>
<section id="p-watch" hidden>
<div class="row">
<input type="text" id="watchQuery" placeholder="Morceau à guetter sur toutes les stations"
onkeydown="if(event.key==='Enter')addWatch()">
<button class="go" onclick="addWatch()">Guetter</button>
<button class="ghost" onclick="sweep()">Balayer maintenant</button>
</div>
<div id="watches"></div>
</section>
<section id="p-queue" hidden><div id="queue"></div></section>
<section id="p-library" hidden><div id="library"></div></section>
<section id="p-settings" hidden>
<div class="card" style="display:block">
<b>Jeton d'accès</b>
<small>Rempli tout seul quand cette page est ouverte depuis la machine du serveur.
Depuis un autre poste, collez celui que donne <code>make server-token</code>.</small>
<div class="row" style="margin-top:12px">
<input type="password" id="token" placeholder="Jeton" style="flex:1">
<button class="go" onclick="saveToken()">Enregistrer</button>
</div>
</div>
<div id="serverInfo"></div>
</section>
<section id="p-about" hidden>
<div class="about-head">
<div class="about-logo">🎧</div>
<div>
<h2 id="aboutName">Noxely</h2>
<p id="aboutTagline"></p>
<div class="row" style="margin:0" id="aboutBadges"></div>
</div>
</div>
<div class="subtabs" id="aboutTabs"></div>
<div class="about-body" id="aboutBody"></div>
</section>
<section id="p-devices" hidden>
<div class="row"><button class="go" onclick="openPairing()">Appairer un appareil</button></div>
<div id="devices"></div>
</section>
</main>
<script src="/about.js"></script>
<script>
const $ = (id) => document.getElementById(id);
let token = localStorage.getItem('noxely-token') || '';
$('token').value = token;
function saveToken() {
token = $('token').value.trim();
localStorage.setItem('noxely-token', token);
refreshAll();
}
async function api(path, options = {}) {
const response = await fetch('/api' + path, {
...options,
headers: { 'X-Noxely-Token': token, 'Content-Type': 'application/json', ...(options.headers || {}) },
});
if (!response.ok) throw new Error((await response.json().catch(() => ({}))).detail || response.status);
return response.json();
}
function show(name) {
for (const tab of ['search', 'watch', 'queue', 'library', 'devices', 'settings', 'about']) {
$('p-' + tab).hidden = tab !== name;
$('t-' + tab).setAttribute('aria-selected', String(tab === name));
}
if (name === 'queue') loadQueue();
if (name === 'library') loadLibrary();
if (name === 'watch') loadWatches();
if (name === 'devices') loadDevices();
if (name === 'settings') loadServerInfo();
if (name === 'about') loadAbout();
}
async function refreshAll() {
try {
const health = await fetch('/api/health').then((r) => r.json());
$('status').textContent = health.name + ' ' + health.version;
$('status').className = 'pill ok';
} catch { $('status').textContent = 'injoignable'; $('status').className = 'pill warn'; }
if (!token) {
$('status').textContent = 'jeton requis → Réglages';
$('status').className = 'pill warn';
}
try {
const { catalogs } = await api('/catalogs');
$('catalog').innerHTML = Object.entries(catalogs)
.map(([id, label]) => `<option value="${id}">${label}</option>`).join('');
} catch {}
}
async function doSearch() {
const q = $('q').value.trim(); if (!q) return;
$('results').innerHTML = '<div class="empty">Recherche…</div>';
try {
const { results } = await api(`/search?catalog=${$('catalog').value}&q=${encodeURIComponent(q)}`);
$('results').innerHTML = results.length ? results.map((r, i) => `
<div class="card">
<div class="grow"><b>${esc(r.title)}</b><small>${
r.catalog ? '<span class="pill">' + esc(r.catalog) + '</span> ' : ''}${
esc(r.artist)} · ${r.kind}${
r.size ? ' · ~' + (r.size / 1e6).toFixed(0) + ' Mo' : ''}</small></div>
<button class="ghost" onclick='openTracks(${i})'>Pistes</button>
</div>`).join('') : '<div class="empty">Aucun résultat</div>';
window._results = results;
} catch (e) { $('results').innerHTML = `<div class="empty">${esc(String(e))}</div>`; }
}
async function openTracks(index) {
const item = window._results[index];
$('results').innerHTML = '<div class="empty">Lecture des pistes…</div>';
try {
// En recherche « toutes sources », c'est le catalogue du résultat qui compte, pas celui du menu.
const catalog = item.catalog || $('catalog').value;
const { tracks } = await api(`/tracks?catalog=${catalog}&id=${
encodeURIComponent(item.id)}&title=${encodeURIComponent(item.title)}&kind=${item.kind}`);
window._catalog = catalog;
window._tracks = tracks;
const total = tracks.reduce((sum, t) => sum + (t.size || 0), 0);
$('results').innerHTML = `
<div class="row"><button class="ghost" onclick="doSearch()">← Résultats</button>
<button class="go" onclick="queueAll()">Tout mettre en file${
total ? ' (' + (total / 1e6).toFixed(0) + ' Mo)' : ''}</button></div>` +
tracks.map((t, i) => `
<div class="card">
<div class="grow"><b>${esc(t.title)}</b><small>${
t.size ? (t.size / 1e6).toFixed(1) + ' Mo' : 'taille inconnue'}</small></div>
<button class="ghost" onclick="queueOne(${i})">Mettre en file</button>
</div>`).join('');
} catch (e) { $('results').innerHTML = `<div class="empty">${esc(String(e))}</div>`; }
}
const queueTracks = async (tracks) => {
const { queued } = await api('/queue', { method: 'POST',
body: JSON.stringify({ tracks, catalog: window._catalog || $('catalog').value }) });
alert(queued + ' piste(s) en file de téléchargement');
};
const queueOne = (i) => queueTracks([window._tracks[i]]);
const queueAll = () => queueTracks(window._tracks);
async function loadQueue() {
try {
const { items } = await api('/queue');
$('queue').innerHTML = items.length ? items.map((m) => `
<div class="card"><div class="grow"><b>${esc(m.title)}</b>
<small>${esc(m.artist)} · ${m.state}${m.error ? ' — ' + esc(m.error) : ''}</small></div></div>`).join('')
: '<div class="empty">File vide</div>';
} catch (e) { $('queue').innerHTML = `<div class="empty">${esc(String(e))}</div>`; }
}
async function loadLibrary() {
try {
const { items } = await api('/library?since=0');
$('library').innerHTML = items.length ? items.map((m) => `
<div class="card"><div class="grow"><b>${esc(m.title)}</b>
<small>${esc(m.artist)} · ${(m.size / 1e6).toFixed(1)} Mo · ${esc(m.source)}</small></div>
<button class="ghost" onclick="removeMedia('${m.id}')">Supprimer</button></div>`).join('')
: '<div class="empty">Rien de prêt pour le mobile</div>';
} catch (e) { $('library').innerHTML = `<div class="empty">${esc(String(e))}</div>`; }
}
async function removeMedia(id) {
if (!confirm('Supprimer définitivement ce média du serveur ?')) return;
await api('/media/' + id, { method: 'DELETE' });
loadLibrary();
}
async function loadWatches() {
try {
const { watches, recording, sweeps, last_sweep: last } = await api('/watches');
const scan = last && last.stations
? `${sweeps} tour(s) · dernier : ${last.stations} stations, ${last.titles} titres lus`
: 'en attente d\'un guet';
$('watches').innerHTML =
`<div class="card"><div class="grow"><b>Balayage continu</b><small>${esc(scan)}</small></div>
<span class="pill ok">actif</span></div>` +
(recording ? `<div class="card"><div class="grow">
<b>Enregistrement en cours</b><small>${esc(recording)}</small></div></div>` : '') +
(watches.length ? watches.map((w) => `
<div class="card"><div class="grow"><b>${esc(w.query)}</b><small>${
w.found_at ? 'capté sur ' + esc(w.found_on || '') + ' — ' + esc(w.found_title || '')
: w.scans + ' balayage(s)'}</small></div>
<span class="pill ${w.found_at ? 'ok' : ''}">${w.found_at ? 'trouvé' : 'en attente'}</span>
<button class="ghost" onclick="removeWatch('${w.id}')">×</button></div>`).join('')
: '<div class="empty">Aucun guet</div>');
} catch (e) { $('watches').innerHTML = `<div class="empty">${esc(String(e))}</div>`; }
}
async function addWatch() {
const query = $('watchQuery').value.trim(); if (!query) return;
await api('/watches', { method: 'POST', body: JSON.stringify({ query }) });
$('watchQuery').value = '';
loadWatches();
}
const removeWatch = async (id) => { await api('/watches/' + id, { method: 'DELETE' }); loadWatches(); };
async function sweep() {
$('watches').innerHTML = '<div class="empty">Balayage des stations…</div>';
try {
const r = await api('/watches/sweep', { method: 'POST' });
alert(r.matched ? `Trouvé sur ${r.station} : ${r.matched}`
: `${r.stations} stations écoutées, ${r.titles} titres lus, rien de guetté`);
} catch (e) { alert(String(e)); }
loadWatches();
}
async function loadServerInfo() {
try {
const health = await fetch('/api/health').then((r) => r.json());
const { devices } = await api('/devices');
$('serverInfo').innerHTML = `
<div class="card"><div class="grow"><b>${esc(health.name)} ${esc(health.version)}</b>
<small>${devices.length} appareil(s) appairé(s)</small></div>
<span class="pill ok">en service</span></div>`;
} catch (e) {
$('serverInfo').innerHTML = `<div class="card"><div class="grow"><b>Jeton requis</b>
<small>${esc(String(e))}</small></div><span class="pill warn">non authentifié</span></div>`;
}
}
async function loadDevices() {
try {
const { devices } = await api('/devices');
$('devices').innerHTML = devices.length ? devices.map((d) => `
<div class="card"><div class="grow"><b>${esc(d.name)}</b><small>appairé le ${
new Date(d.created_at).toLocaleString('fr-FR')}${
d.last_seen ? ' · vu le ' + new Date(d.last_seen).toLocaleString('fr-FR')
: ' · jamais synchronisé'}</small></div>
<button class="ghost" onclick="revokeDevice('${d.id}','${esc(d.name)}')">Révoquer</button></div>`).join('')
: '<div class="empty">Aucun appareil appairé</div>';
} catch (e) { $('devices').innerHTML = `<div class="empty">${esc(String(e))}</div>`; }
}
async function revokeDevice(id, name) {
if (!confirm(`Révoquer « ${name} » ? Il ne pourra plus se synchroniser tant qu'il n'est pas réappairé.`)) return;
await api('/devices/' + id, { method: 'DELETE' });
loadDevices();
}
async function openPairing() {
try {
const { seconds } = await api('/pair/open', { method: 'POST' });
alert(`Appairage ouvert pour ${seconds} secondes.\n\n` +
`Sur le téléphone : Réglages ▸ Connexion ▸ Appairer.\n` +
`La fenêtre se referme dès qu'un appareil s'est servi.`);
} catch (e) { alert('Appairage impossible : ' + e); }
}
/* ── À propos ──────────────────────────────────────────────────────────────
Le contenu vient d'about.js, la version de /api/health et le journal du
CHANGELOG.md du dépôt : rien n'est recopié ici, donc rien ne peut diverger. */
let aboutTab = 'features';
const ABOUT_TABS = [
['features', '⭐ Fonctions'], ['guarantees', '🛡️ Garanties'],
['stack', '🧱 Technique'], ['log', '🕓 Journal'], ['author', '👤 Auteur'],
];
async function loadAbout() {
$('aboutName').textContent = ABOUT.name;
$('aboutTagline').textContent = ABOUT.tagline;
let version = '—', live = false;
try {
const health = await fetch('/api/health').then((r) => r.json());
version = health.version; live = true;
} catch {}
$('aboutBadges').innerHTML =
`<span class="pill accent">v${esc(version)}</span>` +
`<span class="pill">${esc(ABOUT.license)}</span>` +
`<span class="pill ${live ? 'ok' : 'warn'}">${live ? 'en service' : 'injoignable'}</span>` +
`<span class="pill ok">4 catalogues libres</span>`;
$('aboutTabs').innerHTML = ABOUT_TABS.map(([id, label]) =>
`<button onclick="showAbout('${id}')" aria-selected="${id === aboutTab}">${label}</button>`).join('');
renderAbout();
}
function showAbout(id) { aboutTab = id; loadAbout(); }
async function renderAbout() {
const body = $('aboutBody');
if (aboutTab === 'features') {
body.innerHTML = ABOUT.features.map(([title, text]) =>
`<div class="card"><b>${esc(title)}</b><small>${esc(text)}</small></div>`).join('');
} else if (aboutTab === 'guarantees') {
body.innerHTML = `<div class="card"><small>${esc(ABOUT.guaranteesIntro)}</small>
<ul style="margin-top:10px">${ABOUT.guarantees.map((g) => `<li>${esc(g)}</li>`).join('')}</ul></div>`;
} else if (aboutTab === 'stack') {
body.innerHTML = `<div class="card"><table class="tech">${ABOUT.stack.map(([layer, tools]) =>
`<tr><td>${esc(layer)}</td><td>${esc(tools)}</td></tr>`).join('')}</table></div>`;
} else if (aboutTab === 'author') {
body.innerHTML = `<div class="card" style="display:flex;align-items:center">
<div class="about-logo" style="width:52px;height:52px;border-radius:16px;font-size:24px">${
esc(ABOUT.author[0])}</div>
<div class="grow" style="margin-left:14px">
<b>${esc(ABOUT.author)}</b><small>${esc(ABOUT.authorRole)}</small>
<small style="user-select:text;display:block;margin-top:6px">${esc(ABOUT.repository)}</small>
</div></div>
<div class="card"><small>${esc(ABOUT.authorship)}</small>
<small style="display:block;margin-top:6px">${esc(ABOUT.copyright)} — ${esc(ABOUT.license)}</small></div>`;
} else {
body.innerHTML = '<div class="empty">Lecture du journal…</div>';
try {
const text = await fetch('/api/changelog').then((r) => r.text());
body.innerHTML = renderChangelog(text) || '<div class="empty">Journal vide</div>';
} catch { body.innerHTML = '<div class="empty">Journal indisponible</div>'; }
}
}
/* Le CHANGELOG n'emploie que des titres « ## », des puces « - » et du gras :
on n'interprète que cela, plutôt que d'embarquer un moteur Markdown. */
function renderChangelog(text) {
const bold = (s) => esc(s).replace(/\*\*(.+?)\*\*/g, '<b style="display:inline">$1</b>');
const entries = [];
for (const line of text.split('\n')) {
if (line.startsWith('## ')) entries.push({ title: line.slice(3).trim(), items: [] });
else if (line.startsWith('- ') && entries.length) entries[entries.length - 1].items.push(line.slice(2).trim());
}
return entries.map((e) => `<div class="card log"><h4>${bold(e.title)}</h4>
<ul>${e.items.map((i) => `<li>${bold(i)}</li>`).join('')}</ul></div>`).join('');
}
const esc = (s) => String(s).replace(/[&<>"']/g, (c) =>
({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]));
// Consultée depuis la machine du serveur, la page se remplit seule.
(async () => {
if (!token) {
try {
const { token: found } = await fetch('/api/bootstrap').then((r) => r.ok ? r.json() : {});
if (found) { token = found; $('token').value = found; localStorage.setItem('noxely-token', found); }
} catch {}
}
refreshAll();
})();
setInterval(() => {
if (!$('p-queue').hidden) loadQueue();
if (!$('p-watch').hidden) loadWatches();
}, 5000);
</script>
</body>
</html>
+198
View File
@@ -0,0 +1,198 @@
# Noxely — collecte côté serveur, écoute hors connexion côté mobile.
# Copyright © 2026 Johnny (tuxgyver)
#
# Ce programme est un logiciel libre : vous pouvez le redistribuer et le modifier
# selon les termes de la GNU General Public License, version 3 ou ultérieure,
# telle que publiée par la Free Software Foundation.
#
# Il est distribué dans l'espoir d'être utile, mais SANS AUCUNE GARANTIE.
# Voir le fichier LICENSE à la racine du dépôt pour le texte complet.
"""Tâches de fond : file de téléchargement, guet radio et enregistrement.
C'est ici que se déplace la consommation qui pesait sur le téléphone : le serveur balaie les
stations et télécharge, le mobile ne fait plus que récupérer des fichiers prêts.
"""
from __future__ import annotations
import asyncio
import re
import time
from pathlib import Path
import httpx
from .config import Config
from .sources import radio
from .storage import Storage
UA = {"User-Agent": "Noxely/1.0 (https://git.tuxtech.fr/tuxgyver/Noxely)"}
def safe_name(text: str, extension: str) -> str:
cleaned = re.sub(r"[^\w \-.]", "", text).strip().replace(" ", "_")[:80] or "media"
return f"{cleaned}.{extension}"
class Downloader:
"""Vide la file des médias en attente, un à la fois."""
def __init__(self, config: Config, storage: Storage) -> None:
self.config = config
self.storage = storage
self.config.media_dir.mkdir(parents=True, exist_ok=True)
async def run_forever(self) -> None:
while True:
try:
await self.drain()
except Exception as error: # une panne ne doit pas arrêter la boucle
print(f"[noxely] téléchargement : {error}")
await asyncio.sleep(10)
async def drain(self) -> None:
for item in self.storage.pending_downloads():
await self.fetch(item.id, item.remote_url, item.filename)
async def fetch(self, media_id: str, url: str, filename: str) -> None:
target = self.config.media_dir / filename
partial = target.with_suffix(target.suffix + ".part")
self.storage.update_media(media_id, state="downloading", error=None)
try:
async with httpx.AsyncClient(headers=UA, timeout=httpx.Timeout(120.0),
follow_redirects=True) as client:
async with client.stream("GET", url) as response:
response.raise_for_status()
with partial.open("wb") as handle:
async for chunk in response.aiter_bytes(65536):
handle.write(chunk)
partial.replace(target)
self.storage.update_media(media_id, state="ready", size=target.stat().st_size)
except Exception as error:
partial.unlink(missing_ok=True)
self.storage.update_media(media_id, state="failed", error=str(error)[:200])
class Watcher:
"""Balaie les stations à la recherche des morceaux guettés, et les enregistre."""
def __init__(self, config: Config, storage: Storage) -> None:
self.config = config
self.storage = storage
self.recording: str | None = None
#: Dernier tour de balayage, pour que l'interface montre que ça tourne.
self.last_sweep: dict = {}
self.sweeps = 0
async def run_forever(self) -> None:
"""Balaie en continu : un tour enchaîne sur le suivant sans attendre.
Une sonde ne lit que le premier bloc de métadonnées puis referme — quelques dizaines de
kilo-octets par station. C'est ce qui rend le balayage permanent tenable, là où garder
quarante flux ouverts consommerait plusieurs mégabits par seconde en continu.
"""
while True:
try:
if self.storage.pending_watches():
self.last_sweep = await self.sweep()
self.sweeps += 1
else:
# Rien à guetter : inutile de solliciter l'annuaire.
await asyncio.sleep(30)
continue
except Exception as error:
print(f"[noxely] guet : {error}")
await asyncio.sleep(30)
continue
await asyncio.sleep(self.config.watch_interval)
async def sweep(self) -> dict:
pending = self.storage.pending_watches()
if not pending:
return {"stations": 0, "titles": 0, "at": _now(), "matched": None}
found = await radio.stations(limit=self.config.watch_stations)
titles = 0
for group in _chunks(found, self.config.watch_concurrency):
heard = await asyncio.gather(*(radio.now_playing(s["url"]) for s in group))
for station, title in zip(group, heard):
if not title:
continue
titles += 1
hit = next((w for w in pending if w["query"].lower() in title.lower()), None)
if not hit:
continue
if self.recording is None:
asyncio.create_task(self.record(station, title, hit["query"]))
self.storage.mark_watch_found(hit["id"], station["name"], title)
self.storage.mark_watches_scanned([w["id"] for w in pending])
return {"stations": len(found), "titles": titles, "at": _now(),
"matched": title, "station": station["name"]}
self.storage.mark_watches_scanned([w["id"] for w in pending])
return {"stations": len(found), "titles": titles, "at": _now(), "matched": None}
async def record(self, station: dict, title: str, trigger: str) -> None:
"""Enregistre jusqu'à ce que la station annonce un autre morceau."""
self.recording = station["name"]
extension = "aac" if station["codec"].upper().startswith("AAC") else "mp3"
filename = safe_name(title, extension)
media_id = self.storage.add_media(
title=title, artist=station["name"], source="radio", origin=station["name"],
filename=filename, remote_url=None,
mime="audio/aac" if extension == "aac" else "audio/mpeg", state="downloading",
)
target = self.config.media_dir / filename
headers = {**UA, "Icy-MetaData": "1"}
written = 0
try:
async with httpx.AsyncClient(headers=headers, timeout=httpx.Timeout(60.0)) as client:
async with client.stream("GET", station["url"]) as response:
response.raise_for_status()
interval = int(response.headers.get("icy-metaint") or 0)
with target.open("wb") as handle:
written = await self._copy(response, handle, interval, title)
self.storage.update_media(media_id, state="ready", size=written)
except Exception as error:
self.storage.update_media(media_id, state="failed", error=str(error)[:200])
finally:
self.recording = None
async def _copy(self, response, handle, interval: int, wanted: str) -> int:
"""Retire les blocs ICY du flux : laissés dedans, ils rendraient le fichier illisible."""
if interval <= 0:
total = 0
async for chunk in response.aiter_bytes(32768):
handle.write(chunk)
total += len(chunk)
if total > 40_000_000: # garde-fou : 40 Mo sans annonce de fin
break
return total
buffer = bytearray()
total = 0
async for chunk in response.aiter_bytes(32768):
buffer.extend(chunk)
while len(buffer) >= interval + 1:
length = buffer[interval] * 16
if len(buffer) < interval + 1 + length:
break
handle.write(bytes(buffer[:interval]))
total += interval
meta = bytes(buffer[interval + 1:interval + 1 + length]).decode("utf-8", "replace")
del buffer[:interval + 1 + length]
announced = radio.STREAM_TITLE.search(meta)
if announced and announced.group(1).strip() and announced.group(1).strip() != wanted:
return total # le morceau est terminé
if total > 60_000_000:
return total
return total
def _now() -> int:
return int(time.time() * 1000)
def _chunks(items: list, size: int):
for index in range(0, len(items), size):
yield items[index:index + size]
+3
View File
@@ -0,0 +1,3 @@
fastapi>=0.110.0
uvicorn[standard]>=0.29.0
httpx>=0.27.0