-
Notifications
You must be signed in to change notification settings - Fork 38
/
README
156 lines (123 loc) · 5.22 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
Bless - Gtk# Hex Editor v0.6.3
==============================
Copyright (c) 2004-2020, Alexandros Frantzis
Thank you for using ( or at least trying out :) ) Bless!
Contents
1. Description
2. Project Web Site and contact info
3. Requirements
4. Installation
5. Running
6. Documentation
7. Known Issues
--------------
1. Description
--------------
Bless is a binary (hex) editor, a program that enables you to edit files as
a sequence of bytes. It is written in C# and uses the Gtk# bindings for the
GTK+ toolkit.
Bless is distributed under the terms of the GNU General Public License
(GPL-2.0-or-later). See the file COPYING for more information.
Main Features
-------------
* Efficient editing of large data files.
* Raw disk editing.
* Multilevel undo - redo operations.
* Customizable data views.
* Fast data rendering on screen.
* Multiple Tabs.
* Fast Find and Replace operations.
* Conversion Table.
* Advanced Copy/Paste capabilities.
* Multi-threaded search and save operations.
* Export to text and html (others with plugins).
* Extensibility with Plugins.
Planned Features
----------------
* Scripting language for binary file manipulation.
------------------------------------
2. Project Web Site and contact info
------------------------------------
More information, bug reports and the latest releases can be found at:
https://github.com/afrantzis/bless
I can be contacted at: alf82 [at] freemail [dot] gr.
---------------
3. Requirements
---------------
The main target platform for bless is GNU/Linux. However, all the libraries it
uses are cross-platform, so bless should be able to run without problems
on all the major platforms (GNU/Linux, *BSD, Solaris, Win32).
To build and run the current version of bless you need:
* GTK+ >= 2.8.x (Included in all modern GNU/Linux distributions, http://www.gtk.org)
* mono/.NET runtime and C# compiler >= 1.1.14 (http://www.mono-project.com)
* Gtk# bindings >= 2.8 for GTK+ (http://gtk-sharp.sourceforge.net)
* pkg-config (Included in all modern GNU/Linux distributions)
* meson >= 0.46
* nunit and nunit-console, if you want to build and run tests
* xsltproc and docbook stylesheet, if you want to produce HTML documentation
Development is done using the latest stable versions of the above libraries.
Although using an older version may be OK, there is no guarantee that there
will not be problems.
---------------
4. Installation
---------------
Quick:
git clone https://github.com/afrantzis/bless
meson setup build (-Dopt=val --buildtype=type ...)
ninja -C build
(ninja -C build install)
Detailed:
Step 1: Get the source
---------------------------------
To get the latest source:
git clone https://github.com/afrantzis/bless
For a compressed tarball use:
tar -xf bless-a.b.c.tar.gz
Step 2: Configure the build
-----------------------------
Enter the directory created in the previous step (bless or bless-a.b.c). To
configure the build and check that your system has all the required libraries
use:
$ meson setup build (-Dopt=val --buildtype=type ...)
Use the "-Dprefix=PREFIX" option to set the installation directory prefix. By
default the prefix is '/usr/local'.
You can use the "--buildtype=release" option to build bless in release mode,
by default the debug mode is built.
Step 3: Build the program
-----------------------------
Type 'ninja -C build'. This will create 'bless.exe' and the necessary library
files in the build/src directory. You can also type 'ninja -C build test' to
run some tests on various bless components. Note that running the tests
requires the 'nunit-console' binary.
Step 4: Install the program (optional)
--------------------------------------
Become root and type 'ninja -C build install'.
----------
5. Running
----------
If you chose to install the program, just type 'bless'. In any case you can
run the program by typing 'mono build/src/bless.exe' from within the top source
directory. Enjoy!
----------------
6. Documentation
----------------
The doc/ directory contains documentation directed both at the user and at the
developer who wants to explore Bless. The doc/user/ subdirectory contains
information about using bless whereas doc/developer/ contains developer
information (bless api etc).
Note: The developer documentation is almost non-existent.
---------------
7. Known Issues
---------------
* To be able to save a file under the same name (File->Save command) you need
to have (temporarily) enough disk space to hold both the original and the
new file. This happens because the new file is created in the /tmp
directory and then moved to its proper position. For example if you have a
20MB file and edit it so that it becomes 21MB and the new file is supposed to
be saved in the same storage device as /tmp, you need to have 20+21=41MB free
space in that storage device to be able to save it. After a successful save,
the original file is deleted, in this case freeing 20MB.
Although this can be a problem (when there is not enough disk space), it
can also be seen as a safety measure in case something goes wrong when saving.
A notable exception to the above is when the size of the file to be saved has
not been changed. In that case the file is saved in-place.