# Local anime
Follow the steps below to create local anime.
- Create a folder named
localanime
in the/Aniyomi/
folder.- The
/Aniyomi/
folder is located in the root of phone's internal storage or external SD card and it's not related to theeu.kanade.tachiyomi/
folder or the download location in the settings. - If you don't have a
/Aniyomi/
folder located in the folders mentioned above, you can simply create it.
- The
- Place correctly structured anime inside
/Aniyomi/localanime/
.- Optional: If you're adding anime in folders, add a file named
.nomedia
to the local folder so images do not show up in the gallery
- Optional: If you're adding anime in folders, add a file named
- You can then access the anime in → Local anime source.
If you add more episodes then you'll have to manually refresh the episode list (by pulling down the list).
Supported episode formats are .mp4 and .mkv video files.
Remember to give the app storage permissions.
# Folder Structure
Aniyomi requires a specific folder structure for local anime to be correctly processed. Local anime will be read from the Aniyomi/localanime
folder. Each anime must have a Anime
folder. Episode videos will then go into the anime folder. See below for more information on archive files. You can refer to the following example:
Example (Folder)
-
/sdcard/Aniyomi/localanime
- ...
-
/storage/18F5-2C11/Aniyomi/localanime
- ...
Aniyomi will see four episodes in a single anime. The path to the folder with videos must contain both the anime title (as seen above).
Example structure using the file manager
Here, the anime name is test so the file structure is /Aniyomi/localanime/test/episodes
.

# Advanced
# Editing local anime details
It is possible to add details to local anime. Like anime from other catalogs, you add information about the anime such as the author, artist, description, and genre tags.
To import details along with your local anime, you have to create a json file. It can be named anything but it must be placed within the Anime folder. A standard file name is details.json
. This file will contain the extended details about the anime in the JSON
format. You can see the example below on how to build the file. Once the file is there, the app should load the data when you first open the anime or you can pull down to refresh the details.
You can copy the following example and edit the details as needed:
{
"title": "Example Title",
"author": "Example Author/Animation studio",
"artist": "Example Artist/Fansub/whatever",
"description": "Example Description",
"genre": ["genre 1", "genre 2", "etc"],
"status": "0",
"_status values": ["0 = Unknown", "1 = Ongoing", "2 = Completed", "3 = Licensed", "4 = Publishing finished", "5 = Cancelled"]
}
If you don't want to manually create the details.json
file for anime, you can alternatively use this tool (opens new window).
# Using a custom cover image
It is also possible to use a custom image as a cover for each local anime.
To do this, you only need to place the image file, that needs to be named
cover.jpg
, in the root of the anime folder. The app will then use your
custom image in the local source listing.