Skip to content

Commit

Permalink
issue #106 cleanup documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
tobexyz committed Apr 9, 2024
1 parent fffaa4b commit 69ddd9a
Show file tree
Hide file tree
Showing 50 changed files with 47 additions and 460 deletions.
10 changes: 5 additions & 5 deletions docs/_config.yml
Expand Up @@ -18,13 +18,13 @@
# You can create any custom variable you would like, and they will be accessible
# in the templates via {{ site.myvariable }}.

title: YAACC - Android UPNP/DLNA Client and Server
title: YAACC - Android UPnP/DLNA Client and Server
email:
description: >- # this means to ignore newlines until "baseurl:"
The App allows you to play media from UPNP/DLNA devices in your network
on your android device or any capable UPNP device in your network.
It is also possible to start an UPNP server on your device in order
to play media from your device on any UPNP renderer in your network.
Play media from UPnP/DLNA devices in your network
on your android device or any capable UPnP/DLNA device in your network.
It is also possible to start an UPnP/DLNA server on your device and play
media from your device on any UPnP/DLNA renderer in your network.
baseurl: "/yaacc-code/" # the subpath of your site, e.g. /blog
url: "https://tobexyz.github.io" # the base hostname & protocol for your site, e.g. http://example.com
twitter_username:
Expand Down
5 changes: 3 additions & 2 deletions docs/about.md
Expand Up @@ -6,8 +6,9 @@ permalink: about/

# About

YAACC (Yet Another Android Client Controller) is a hobby project I am working on in my free time. So
it's not perfect and I am only able to test the app with my own hardware setup.
YAACC (Yet Another Android Client Controller) is a hobby project
I am working on in my free time. So it's not perfect and I am
only able to test the app with my own hardware setup.

Please, help improving YAACC by reporting problems or sending pull requests.

Expand Down
31 changes: 16 additions & 15 deletions docs/index.md
@@ -1,33 +1,34 @@
---
layout: default
---

<!-- markdownlint-configure-file {
"first-line-h1": false
} -->

* TOC
{:toc}
{:toc}

# Features

* UPNP/DLNA Server - share files of your device in the network
* UPNP/DLNA Client - receive media from other devices on your device
* UPNP/DLNA Controller - control media renderer in the network
* UPnP/DLNA Server - share files of your device in the network
* UPnP/DLNA Client - receive media from other devices on your device
* UPnP/DLNA Controller - control media renderer in the network
* Control multiple media renderer
* Allow download files to the device
* Allow sharing of urls and sending them to the current media renderers
* Use your device as an proxy if your media renderer can't process https media urls
* Allow sharing of URLs and sending them to the current media renderers
* Use your device as an proxy if your media renderer can't process https media URLs

# Usage

On the first screen all UPNP/DLNA servers in your network are listed.
Select one and the app will atomatically switch to the content tab.
On the first screen all UPnP/DLNA servers in your network are listed.
Select one and the app will automatically switch to the content tab.
It allows to browse the content provided by the selected server.

![browse_servers](./screenshots/4.1.x/browse_servers.png){:height="30%" width="30%"}

Before selecting content make sure you have choosen an receiver on
the receiver tab. Receivers are either UPNP/DLNA media renderers in
Before selecting content make sure you have chosen an receiver on
the receiver tab. Receivers are either UPnP/DLNA media renderers in
your network or the android device itself.

![browse_receiver](./screenshots/4.1.x/browse_receiver.png){:height="30%" width="30%"}
Expand Down Expand Up @@ -84,23 +85,23 @@ The icons behind the server switch are showing which service is activated.
## Media provider

If the device is used as media provider, media files stored on the device
are accessible for other UPNP/DLNA devices in you network.
are accessible for other UPnP/DLNA devices in you network.
At the moment there are no restrictions beside the content type,
which files are accessible and which are not.
Be aware of this when activating the service!

## Media renderer

This service allows your device acting as an media renderer. Therefore the
device can be controlled by other UPNP/DLNA controllers in your network
and receive and play media from UPNP/DLNA servers.
device can be controlled by other UPnP/DLNA controllers in your network
and receive and play media from UPnP/DLNA servers.

## Media proxy

The proxy service is used in the context of sharing URLs with YAACC and
playing the url on a UPNP/DLNA device in your network. Normally the
playing the URL on a UPnP/DLNA device in your network. Normally the
URL will directly passed to the rendering device. Sometimes the rendering
device is not able to play https urls. Therefore we need to get rid of the
device is not able to play https URLs. Therefore we need to get rid of the
encryption and provide the content with an unencrypted http URL.
For this the proxy service can be used. In that case the URL shared with
YAACC will not directly passed to the rendering device. YAACC generates a
Expand Down
Binary file added docs/screenshots/4.2.x/browse_content_folder.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/screenshots/4.2.x/browse_image_folder.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/screenshots/4.2.x/browse_music_folder.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/screenshots/4.2.x/browse_player.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/screenshots/4.2.x/browse_receiver.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/screenshots/4.2.x/browse_servers.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/screenshots/4.2.x/image_player.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/screenshots/4.2.x/image_player_show_menu.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/screenshots/4.2.x/music_player.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions docs/settings.md
Expand Up @@ -17,7 +17,7 @@ permalink: settings/
| **media browsing behavior** | category for media browsing settings |
| thumbnails | show thumbnails or not|
| cover images | search for cover images in media files or use a cover.jpg file within the directories |
| number of threads | Configure the number of threads used for loading content from the UPNP server. More threads causes faster loading but increase the possibility of errors. Changes are effect after restart of yaacc. |
| number of threads | Configure the number of threads used for loading content from the UPnP server. More threads causes faster loading but increase the possibility of errors. Changes are effect after restart of YAACC. |
| chunk size when browsing |amount of items fetched from server in one request |
| **media playing behavior** | category for media playing settings |
| default item duration | default item duration if media file provides no duration information |
Expand All @@ -35,5 +35,5 @@ permalink: settings/
| serve images | activate or deactivate publishing of images |
| serve music | activate or deactivate publishing of music |
| serve videos | activate or deactivate publishing of music |
| sending UPNP alive notifications | define the frequency for sending UPNP alive notifications |
| sending UPnP alive notifications | define the frequency for sending UPnP alive notifications |
| network name for local server| display name of the media server |
76 changes: 0 additions & 76 deletions wiki/Documentation.md

This file was deleted.

9 changes: 0 additions & 9 deletions wiki/FAQ.md

This file was deleted.

8 changes: 0 additions & 8 deletions wiki/GlobalMenu.md

This file was deleted.

12 changes: 0 additions & 12 deletions wiki/MusicPlayer.md

This file was deleted.

31 changes: 0 additions & 31 deletions wiki/Releases.md

This file was deleted.

12 changes: 0 additions & 12 deletions wiki/Screenshots.md

This file was deleted.

10 changes: 0 additions & 10 deletions wiki/SettingsMenu.md

This file was deleted.

59 changes: 0 additions & 59 deletions wiki/ToDos.md

This file was deleted.

29 changes: 0 additions & 29 deletions wiki/Tools.md

This file was deleted.

13 changes: 0 additions & 13 deletions wiki/VideoPlayer.md

This file was deleted.

0 comments on commit 69ddd9a

Please sign in to comment.