[Config] get internal IPs from environment
[mygpo.git] / doc / user / index.rst
blobe893395a5fdc0216c170c85c54a4a5f924dba6a4
1 User Documentation
2 ==================
4 `gpodder.net <https://gpodder.net>`_ is a web service to manage your podcast
5 subscriptions via the web. You can synchronize your devices, view status
6 information and discover new interesting podcasts online.
8 Supported Clients
9 -----------------
11 A list of supported clients is available `in the gPodder wiki
12 <http://wiki.gpodder.org/wiki/Web_Services/Clients>`_.
14 To configure gPodder to connect to gpodder.net, open the my.gpodder.org /
15 gpodder.net configuration dialog from the Subscriptions menu. Enter username
16 and password that you've used during the registration on the webservice. The
17 device ID is automatically generated from the hostname and will be used to
18 identify this specific device in the webservice. Next enable the
19 synchronisation of your subscription list. For the start, upload your
20 subscription list to the webservice. Subsequent changes will be transmitted
21 automatically.
23 Devices
24 -------
26 Each device connected to the webservice will be identified by its *Device ID*
27 which should therefore be unique (at least for your user account). *Do not try
28 to synchronize devices by using the same Device ID.*
30 A list of your devices can be found on the `devices page
31 <https://gpodder.net/devices/>`_.
33 Synchronizing Devices
34 ^^^^^^^^^^^^^^^^^^^^^
36 If you have at least two devices connected to the webservice, you can
37 synchronize some of them. Open the device page for one of them, click
38 synchronize and select the device to synchronize with. After synchronizing, the
39 subscriptions of the devices will be merged. Adding a subscription at one
40 device will automatically add it to the others. Same for deletions.
42 The `device list <https://gpodder.net/devices/>`_ groups devices that are
43 synchronized with each other.
45 Episode States
46 --------------
48 Episode states (such as played, downloaded, etc) are synchronized across all devices.
50 Privacy Settings
51 ----------------
53 By default we include information about your subscriptions in our `toplist
54 <https://gpodder.net/toplist/>`_ and `podcast suggestions
55 <https://gpodder.net/suggestions/>`_ . *We will never associate your username
56 and/or email address with your subscriptions on public pages.* You can even
57 opt-out from our anonymized statistics at the privacy page. If you mark some
58 podcasts as private, they will also not show up in your sharable subscription
59 list.
61 Sharing your Subscriptions
62 --------------------------
64 If you want to let others know about your which podcasts you are listening to,
65 go to your `sharing page <https://gpodder.net/share/>`_ . You can either share
66 your private URL with your friends or make it public and share your
67 subscriptions with the whole world.