README 2.51 KB
Newer Older
Mictronics's avatar
Mictronics committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# moserial

moserial is a clean, friendly gtk-based serial terminal for the gnome desktop. It is written in [Vala](https://wiki.gnome.org/Vala).

## Features

- ASCII and HEX views of incoming and outgoing data
- Logging to file of incoming and/or outgoing data
- Support for x, y, and z-modem file send and receive
- Support for profile files, to load/save common configurations
- Easier to use than the alternatives
- Supports i18n
- It even has docs! 

For more information see [GNOME wiki](https://wiki.gnome.org/Apps/Moserial).

## Build

Jordan Williams's avatar
Jordan Williams committed
19
20
### Flatpak

21
22
23
24
25
26
Get the source code.
```
git clone --recursive https://gitlab.gnome.org/GNOME/moserial.git
cd moserial
```

Jordan Williams's avatar
Jordan Williams committed
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
Add the Flathub repository.
```
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
```

Add the GNOME Nightly repository.
```
flatpak remote-add --user --if-not-exists gnome-nightly https://nightly.gnome.org/gnome-nightly.flatpakrepo
```

Install the GNOME Platform and SDK.
```
flatpak install --user gnome-nightly org.gnome.Sdk//master org.gnome.Platform//master
```

Install Flatpak Builder.
```
sudo apt-get install flatpak-builder
```

Build the Flatpak.
```
flatpak-builder --user --install --force-clean --repo=repo moserial org.gnome.moserial.Devel.yaml
```

Run the Flatpak.
```
Jordan Williams's avatar
Jordan Williams committed
54
flatpak run org.gnome.moserial.Devel
Jordan Williams's avatar
Jordan Williams committed
55
56
57
58
59
```

### Build from Source

#### Dependencies
Mictronics's avatar
Mictronics committed
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

Install the following build dependencies:

`sudo apt-get install libglib2.0-dev yelp-tools graphviz-dev libgtk-3-dev`

At least libgtk v3.20 is required.

Get the Vala compiler from [here](https://download.gnome.org/sources/vala/)
Required version v0.48.5 or later.

Extract files to folder then run inside that folder:
```
./configure
make
sudo make install
```

Jordan Williams's avatar
Jordan Williams committed
77
#### Manually build
Mictronics's avatar
Mictronics committed
78
79

```
80
git clone https://gitlab.gnome.org/GNOME/moserial.git
Mictronics's avatar
Mictronics committed
81
82
83
84
85
86
87
88
89
cd moserial/
```
On 32 bit systems:
```
./autogen.sh --prefix=/usr 
make
```
On 64 bit systems:
```
Jordan Williams's avatar
Jordan Williams committed
90
./autogen.sh --prefix=/usr --libdir '/usr/lib64' --build x86_64
Mictronics's avatar
Mictronics committed
91
92
93
94
95
make
```
Optional:
`sudo make install`

Jordan Williams's avatar
Jordan Williams committed
96
#### Build issues
Mictronics's avatar
Mictronics committed
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

A. If you see this error:
   src/SerialConnection.c:31:21: fatal error: stropts.h: No such file or directory

   then either:

   1. sudo touch /usr/include/stropts.h

   or

   2. patch your posix.vapi file as described at
   http://bugzilla.gnome.org/show_bug.cgi?id=656690#c3

B. moserial does not implement the xmodem, ymodem, or zmodem protocols
   directly. It relies on the standard rz and sz utilities to send and
   receive data. These utilities, part of the lrzsz package, must be
   installed on your system.