Stars: 394
Forks: 36
Pull Requests: 391
Issues: 486
Watchers: 7
Last Updated: 2023-09-17 10:07:19
π π Smart media tagging for Nextcloud: recognizes faces, objects, landscapes, music genres
License: GNU Affero General Public License v3.0
Languages: Makefile, PHP, JavaScript, Vue
This app goes through your media collection and adds fitting tags, automatically categorizing your photos and music.
β‘ Tagging works via Nextcloud's Collaborative Tags
Model sizes:
Positive:
Positive:
Positive:
Positive:
Negative:
Learn more about the Nextcloud Ethical AI Rating in our blog.
(Screenshot by @_DigitalWriter_)
This app does not send any sensitive data to cloud providers or similar services. All image processing is done on your nextcloud machine, using Tensorflow.js running in Node.js, which comes bundled with this app.
This is the list of recognized things and which categories they are currently mapped to. I'm happy to accept pull requests for this file to fine tune predictions.
Recognize uses
Learn more about what's going on behind the scenes in this wiki article and this forum post.
This app temporarily stores files to be recognized in /tmp. If you're using docker, you might find that adding an additional volume for /tmp speeds things up and eases the burden on your disk:
docker run
: Add --mount type=tmpfs,destination=/tmp:exec
to command line.
docker compose
: Add the following to the volume section docker-compose.yml
:
app:
image: nextcloud:26
...
volumes:
- type: tmpfs
target: /tmp:exec
...
...
Go to "Apps" in your nextcloud, search for "recognize" and click install.
Help: If one-click install fails
Any configuration is done in Settings/Recognize of your Nextcloud instance.
If you want path/to/your/folder/* to be excluded from image recognition, add a file path/to/your/folder/.noimage
. If you want to exclude it from music genre recognition, add a file path/to/your/folder/.nomusic
. If you want to exclude it from video recognition, add a file path/to/your/folder/.novideo
. If you want to exclude it from all recognition, add a file path/to/your/folder/.nomedia
.
cd /path/to/nextcloud/apps/
git clone https://github.com/marcelklehr/recognize.git
cd recognize
make
While there are some things that could be done to further improve this app, the app is currently maintained with limited effort. This means:
We would be more than excited if you would like to collaborate with us. We will merge pull requests for new features and fixes. We also would love to welcome co-maintainers.
If you are a customer of Nextcloud and you have a strong business case for any development of this app, we will consider your wishes for our roadmap. Please contact your account manager to talk about the possibilities.
We always welcome contributions. Have an issue or an idea for a feature? Let us know. Additionally, we happily accept pull requests.
In order to make the process run more smoothly, you can make sure of the following things:
Please read the Code of Conduct. This document offers some guidance to ensure Nextcloud participants can cooperate effectively in a positive and inspiring atmosphere, and to explain how together we can strengthen and support each other.
More information on how to contribute: https://nextcloud.com/contribute/
Happy hacking β€οΈ
This software is licensed under the terms of the AGPL written by the Free Software Foundation and available at COPYING.
The recognize logo Smart tag by Xinh Studio from the Noun Project is licensed under a Creative Commons Attribution license.