README.md 1.93 KB
Newer Older
1
2
# ARSnova Presenter

3
4
5
6
7
8
9
10
11
12
13
ARSnova is a web-based Audience Response System which allows you to get instant
feedback from your students. It helps you to get a better understanding about
the learning progress of your students and to identify topics which might need
to be discussed in more detail.

Presenter is an ARSnova frontend for lecturers intended to be used for
preparation and presentation of ARSnova sessions. It focuses on modern didactic
concepts, especially Peer Instruction. But it can still be used for quick and
simple surveys.

In contrast to [ARSnova Mobile](https://github.com/thm-projects/arsnova-mobile),
14
Presenter targets desktop browsers. It is designed to be fully compatible with
15
16
the mobile frontend.

17
Presenter is [open source](COPYING) software. If you are a developer, interested
18
19
20
21
22
23
in didactics and want to help us making it even better, you might also want to
take a look at the [information for contributors](CONTRIBUTING.md).

## Install

Presenter is provided packaged as a web archive file (.war) which can be
24
25
deployed on a Java servlet container. You can download it from the
[releases page](https://github.com/thm-projects/arsnova-presenter/releases) or
26
[build it yourself](CONTRIBUTING.md) with [Grunt](http://gruntjs.com/)
Daniel Gerhardt's avatar
Daniel Gerhardt committed
27
(`grunt package`). Usually it is enough to copy this file to the webapps
28
29
30
31
directory of the container. Since Presenter does not contain any code that has
to be run on the server side, it is also possible to use it with a standard web
server. In this case extract the contents of the .war file with an archiving
tool of your choice.
32
33
34
35
36
37

Presenter depends on the ARSnova API which is provided by
[ARSnova Backend](https://github.com/thm-projects/arsnova-backend). Refer to its
own documentation for installation steps. In case you intent to run Presenter on
a different (sub)domain than the backend, you need to setup the backend for
cross-origin resource sharing (CORS).
38

Daniel Gerhardt's avatar
Daniel Gerhardt committed
39
## License
40

41
GPLv3 or later, see [COPYING](COPYING) file